AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Comunicación / Bluetooth
  • Casos especiales
  • Limitaciones
  • Permisos necesarios
  • Hilos y reloj de arena
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Devuelve la lista de dispositivos Bluetooth accesibles.
Widget Android Atención:
  • Las funciones de Bluetooth no están disponibles en el emulador de Android.
  • La gestión de Bluetooth está disponible desde Android 2.0.
Ejemplo
sTmpString is string
sListDevices is string
// Returns the list of devices
HourGlass(True)
sListDevices = BTListDevice()
HourGlass(False)
// Clear the Table control where the devices are listed
TableDeleteAll(TABLE_Devices)
// Fills the Table control
IF sListDevices <> "" THEN
FOR EACH STRING sTmpString OF sListDevices SEPARATED BY CR
TableAdd(TABLE_Devices, sTmpString)
END
ELSE
Info(ErrorInfo(errFullDetails))
END
Sintaxis
<Result> = BTListDevice([<Level of details> [, <Type of Elements to List> [, <Timeout> [, <Radio identifier>]]]])
<Result>: Cadena de caracteres
  • Lista de dispositivos Bluetooth disponibles,
  • Cadena vacía ("") si se produce un error. La función ErrorInfo permite obtener más detalles sobre el problema.
Esta lista tiene el siguiente formato:
  • en modo simple:
    <Device Identifier 1> + TAB + <MAC Address 1> + TAB + <Name 1> + CR + ...
    + CR + <Device Identifier N> + TAB + <MAC Address N> + TAB + <Name N>
  • en modo detallado:
    <Device Identifier 1> + TAB + <MAC Address 1> + TAB + <Name 1> + TAB +
    <Class 1 Identifier> + TAB + <Connected 1> + TAB + <Stored 1> + TAB +
    <Authenticated 1> + TAB + <View Date 1> + TAB + <Date Used 1> + CR + ... + CR +
    <Device N Identifier> + TAB + <MAC Address N> + TAB + <Name N> + TAB +
    <Class N Identifier> + TAB + <Connected N> + TAB + <Stored N> + TAB +
    <Authenticated N> + TAB + <View Date N> + TAB + <Date Used N>
Se devuelve la siguiente información:
  • <Identificador de Dispositivo>>Dispositivo: Identificador del dispositivo, se utilizará en las funciones Bluetooth que los dispositivos manipular.
  • Dirección MAC> <MAC: Dirección física del dispositivo.
  • <Nombre>: Nombre devuelto por el dispositivo (puede ser una cadena vacía).
  • <Identificador clase>: Clase del dispositivo (entero de 32 bits utilizado para obtener información sobre el tipo de dispositivo). Esta clase puede corresponder a una de las siguientes constantes:
    • btCoD_RedAcceso
    • btCoD_AudioVideo
    • btCoD_pers
    • btCoD_Imagen
    • btCoD_Desconocido
    • btCoD_Juguete
    • btCoD_Computadora
    • btCoD_Dispositivo
    • btCoD_Teléfono
    • btCoD_Llevable
  • <Conectado>: 1 si el dispositivo está actualmente "conectado" al ordenador actual, 0 en caso contrario.
    AndroidWidget Android Esta información no está soportada y siempre corresponderá a 0.
  • <Almacenado: 1 si el dispositivo es actualmente "recordado" por el dispositivo Bluetooth del ordenador actual, 0 en caso contrario.
    AndroidWidget Android Esta información no está soportada y siempre corresponderá a 0.
  • <Autenticado>>Autentificado: 1 si el dispositivo está actualmente autenticado junto al ordenador actual, 0 en caso contrario.
  • <Ver Fecha>: Fecha y hora en que el dispositivo fue visto por última vez por el ordenador actual. Esta fecha está en formato DDMMYYYYYHHMMSS. Esta información se proporciona sólo para los dispositivos recordados.
    AndroidWidget Android Esta información no está soportada y siempre corresponderá a una cadena vacía (""").
  • <Fecha utilizada>: Fecha y hora de la última vez que se utilizó el dispositivo por última vez. Esta fecha está en formato DDMMYYYYYHHMMSS. Esta información se proporciona sólo para los dispositivos recordados.
    AndroidWidget Android Esta información no está soportada y siempre corresponderá a una cadena vacía (""").
<Level of details>: Constante opcional de tipo Integer
Nivel de detalle de los resultados:
btLista detallada<Resultado> contiene la lista de dispositivos en modo detallado.
btListaSimple
(Valor predeterminado)
<Resultado> contiene la lista de dispositivos en modo simple.
<Type of Elements to List>: Constante o combinación de constantes de tipo Integer (opcional)
Estado de los dispositivos a seleccionar:
btStatusAutentificadoPropone los dispositivos autentificados.
btStatusConnectadoPropone los dispositivos conectados.
AndroidWidget Android Esta constante no está disponible.
btStatusDesconocidoPropone los dispositivos desconocidos.
btStatusRecordadoPropone los dispositivos recordados.
AndroidWidget Android Esta constante no está disponible.
btStatusAll
(Valor predeterminado)
Propone todos los dispositivos.
<Timeout>: Entero opcional
Tiempo de espera en segundos (entre 1 y 60) cuando se buscan dispositivos.
El valor predeterminado de este parámetro es 10.
<Radio identifier>: Entero opcional
Identificador de la radio Bluetooth a utilizar. Este identificador es devuelto por BTListRadio.
AndroidWidget Android Este parámetro no es compatible y se ignorará si se especifica.
Observaciones

Casos especiales

  • Un dispositivo autenticado se recuerda necesariamente (y no al revés).
  • Los dispositivos se listan interrogando al entorno hasta que el <Tiempo de espera> de la función. En este intervalo de tiempo, los dispositivos pueden no tener tiempo suficiente para comunicar su identidad.. Entonces, todo lo que tiene que hacer es usar BTInfoDevice para obtener la información que falta.

Limitaciones

  • Windows Esta versión sólo soporta las pilas de bluetooth de Microsoft, Bluesoleil y Broadcom (Widcomm).. Las pilas Broadcom (Widcomm) no están disponibles en 64 bits.
  • Para conocer la pila utilizada, llame a BTStack.
  • Para obtener más información, consulte ¿Qué pilas utilizar?
AndroidWidget Android

Permisos necesarios

La llamada a esta función modifica los permisos requeridos por la aplicación.
Permisos necesarios :
  • BLUETOOTH: este permiso permite que las aplicaciones se conecten a los servicios Bluetooth.
  • BLUETOOTH_ADMIN: este permiso permite a las aplicaciones descubrir y conectar los servicios Bluetooth.
  • ACCESS_COARSE_LOCATION: este permiso permite a una aplicación acceder a una ubicación indefinida (Cell-ID, WiFi).
Caso específico de Android 11: Esta función requiere la Permission ACCESS_BACKGROUND_LOCATION para acceder a la ubicación del dispositivo.
Esta Permission permite utilizar la función cuando la aplicación está en la Background.
Si la aplicación necesita utilizar la ubicación de Background:
  • Agregar manualmente el permiso "ACCESS_BACKGROUND_LOCATION" en el asistente de generación de la aplicación Android.
  • Solicitar explícitamente la ubicación de fondo Permission con PermissionRequest. Por ejemplo:
    PermissionRequest(permBackgroundLocation, Callback)
    INTERNAL PROCEDURE Callback(p is Permission)
    IF p.Granted THEN
    // Functions that require background location access can be used
    END
    END
Una ventana permite a los usuarios:
  • permitir el acceso a la ubicación del dispositivo mientras la aplicación está en la Background,
  • permitir el acceso a la ubicación sólo mientras la aplicación está en uso,
  • negar el acceso a la ubicación. El usuario puede cambiar estos permisos en cualquier momento en la configuración de Android.

Observaciones:
  • Siga las directrices de Google para las aplicaciones que requieren acceso a la ubicación de Background. Para obtener más información, consulte https://support.google.com/googleplay/android-developer/answer/9799150. Si no se cumplen estas condiciones (especialmente los requisitos de información del usuario), es posible que no se acepte la publicación de las aplicaciones en Google Play.
  • La ubicación de fondo Permission sólo debe solicitarse si se ha concedido la ubicación Permission. De lo contrario, PermissionRequest fallará.
  • Si la opción elegida por el usuario para la solicitud de acceso a la localización de Background es más restrictiva que la opción elegida para la solicitud de acceso a la localización, la aplicación se reiniciará automáticamente.
  • En los dispositivos con Android 10 o anterior, si se ha concedido la ubicación Permission a la aplicación, se concederá la ubicación de fondo Permission sin mostrar una ventana.
AndroidWidget Android

Hilos y reloj de arena

Si la función es ejecutada por el hilo principal de la aplicación, se mostrará un reloj de arena (barra de progreso infinito) durante la detección de dispositivos bluetooth..
Para especificar el mensaje que se mostrará en el reloj de arena, utilice NextTitle antes de la llamada a BTListDevice.
Componente: wd290com.dll
Versión mínima requerida
  • Versión 12
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 21/06/2023

Señalar un error o enviar una sugerencia | Ayuda local