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 / Funciones BTLE
  • Permisos necesarios
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
Se utiliza para conectarse a un dispositivo Bluetooth de bajo consumo.
Hay dos sintaxis disponibles:
  • Sintaxis 1: Conexión de bloqueo.
  • Sintaxis 2: Conexión sin bloqueo. Esta sintaxis se utiliza para conectar a un dispositivo Bluetooth desde su Address físico. Puede, por ejemplo, conectar la aplicación a un dispositivo cuya Address física se almacenó durante una detección anterior (con BTLEListDevice) en cuanto este dispositivo se enciende y/o entra en el área de detección de dispositivos.
En Windows, esta función no tiene ningún efecto.. El sistema determina automáticamente si una conexión debe abrirse o no cuando se realiza una solicitud. Sin embargo, debe utilizar BTLEInitialize para set el tipo de btleDevice a un estado válido.
Ejemplo
myDevice is btleDevice
BTLEConnect(myDevice)
Sintaxis

Conectarse a un dispositivo Bluetooth de baja energía (conexión de bloqueo) Ocultar los detalles

<Result> = BTLEConnect(<Device> [, <Timeout>])
<Result>: booleano
  • True si se estableció la conexión,
  • False en caso contrario. ErrorInfo devuelve más información sobre el error.
<Device>: btleDevice Variable
Nombre del btleDevice Variable que representa el dispositivo Bluetooth Low Energy con el que se establecerá la conexión. Este dispositivo fue detectado por BTLEListDevice.
<Timeout>: Entero o duración opcional
Tiempo de espera de la conexión (en milisegundos). Si no se establece la conexión durante este tiempo, el valor de <Resultado> es False.
Si no se especifica este parámetro, el tiempo de espera de la conexión por defecto es set a 5 segundos.
Este parámetro puede ser:
  • un número entero que corresponde al número de milisegundos,
  • una variable de tipo Duration,
  • la duración en un formato legible (por ejemplo, 1 s o 10 ms).

Conectarse a un dispositivo Bluetooth de baja energía (conexión sin bloqueo) Ocultar los detalles

BTLEConnect(<Device> , <WLanguage procedure>)
<Device>: btleDevice Variable o cadena de caracteres
  • Nombre del btleDevice Variable que representa el dispositivo Bluetooth Low Energy con el que se establecerá la conexión.
  • Identificador del dispositivo Bluetooth Low Energy con el que se establecerá la conexión (propiedad Identifier del tipo btleDevice).
    iPhone/iPad Atención: El dispositivo debe haber sido identificado por BTLEListDevice desde el inicio de la aplicación.
No es necesario que el dispositivo esté accesible durante la llamada.: la conexión se establecerá tan pronto como el dispositivo sea accesible. Se llamará al Procedure siempre que se encienda el dispositivo y/o cuando entre en el área de detección del dispositivo.
<WLanguage procedure>: Nombre de Procedure
Nombre del lenguaje WLanguage Procedure ("callback" Procedure) que se llamará cuando se conecte al dispositivo Bluetooth Low Energy..
Este procedimiento tiene el siguiente formato:
PROCEDURE <Procedure name> (<Device>, <Result>)
donde:
  • es un Variable de tipo btleDevice que corresponde al dispositivo Bluetooth conectado.
  • es un booleano Variable:
    • True si se estableció la conexión,
    • False en caso contrario. ErrorInfo devuelve más información sobre el error.
Observaciones
Android

Permisos necesarios

La llamada a esta función modifica los permisos requeridos por la aplicación.
Permiso necesario: BLUETOOTH.
Esta Permission permite que las aplicaciones se conecten a los servicios Bluetooth.
Clasificación Lógica de negocio / UI: Lógica de negocio
Componente: wd290android.aar
Versión mínima requerida
  • Versión 21
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 28/06/2023

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