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
  • Varios
  • Versiones necesarias
  • 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
Devuelve la lista de dispositivos Bluetooth Low Energy.
Ejemplo
BTLEListDevice(ProcDetectDevice)
...
INTERNAL PROCEDURE ProcDetectDevice(ADevice)
// Process ADevice
END
Sintaxis
BTLEListDevice(<WLanguage procedure> [, <Timeout>])
<WLanguage procedure>: Nombre de Procedure
Nombre del lenguaje WLanguage Procedure ("callback") llamado para listar los dispositivos. Esta Procedure se utiliza para la información de la get sobre los dispositivos encontrados.
Este procedimiento tiene el siguiente formato:
PROCEDURE <Procedure name> (<Device>, <Signal intensity>)

donde:
  • es un btleDevice Variable correspondiente al dispositivo conectado.
  • es un número entero correspondiente a la intensidad de la señal expresada en decibelios por metro.
Si el procedimiento devuelve False, el análisis de los dispositivos accesibles se detendrá inmediatamente.
<Timeout>: Entero o duración opcional
Tiempo de espera para la búsqueda (en segundos). Este parámetro puede ser:
  • un número entero que corresponde al número de segundos,
  • una variable de tipo Duration,
  • la duración en un formato legible (por ejemplo, 1 s).
Si no se especifica este parámetro, el tiempo de espera por defecto es set a 10 segundos.
Observaciones

Varios

Si se llama a BTLEListDevice cuando hay un análisis en curso, el análisis anterior se detendrá y se iniciará uno nuevo.

Versiones necesarias

  • Android Aplicaciones Android:
    • Las funciones de Bluetooth Low Energy WLanguage sólo están disponibles en dispositivos con Android 4.3 o posterior (nivel 18 de API).
    • Si se utiliza la función con una versión anterior del sistema, se produce un error fatal.
    • Para determinar la versión de Android en la que se está ejecutando la aplicación, utilice la función SysAndroidVersion.
  • iPhone/iPadIOS WidgetMac Catalyst Aplicaciones iOS:
    Las funciones Bluetooth Low Energy de WLanguage están disponibles para los dispositivos que ejecutan iOS 9.
  • Windows Aplicaciones WEBDEV:
Android

Permisos necesarios

La llamada a esta función modifica los permisos requeridos por la aplicación.
Permisos necesarios:
  • BLUETOOTH: esta Permission permite que las aplicaciones se conecten a los servicios Bluetooth.
  • ACCESS_COARSE_LOCATION: esta Permission permite que una aplicación acceda 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.
Clasificación Lógica de negocio / UI: Lógica de negocio
Componente: wd290com.dll
Versión mínima requerida
  • Versión 21
Esta página también está disponible para…
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