DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions BTLE
  • Permissions requises
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Permet de se connecter à un périphérique Bluetooth Low Energy.
Deux syntaxes sont disponibles :
  • Syntaxe 1 : Connexion bloquante.
  • Syntaxe 2 : connexion non bloquante. Cette syntaxe permet de se connecter à un périphérique Bluetooth à partir de son adresse physique. Il est par exemple possible de connecter l'application à un périphérique dont l'adresse physique a été mémorisée lors d'une précédente détection (avec la fonction BTLEListePériphérique) dès que ce périphérique s'allume et/ou entre dans la zone de détection de l'appareil.
Sous Windows, cette fonction est inutile. En effet, le système détermine automatiquement si une connexion doit être ouverte ou non lors d'une requête. Il faut cependant utiliser la fonction BTLEInitialise pour positionner le type btlePériphérique dans un état valide.
Exemple
monPeriph est un btlePériphérique
BTLEConnecte(monPeriph)
Syntaxe

Se connecter à un périphérique Bluetooth Low Energy (connexion bloquante) Masquer les détails

<Résultat> = BTLEConnecte(<Périphérique> [, <Délai d'attente>])
<Résultat> : Booléen
  • Vrai si la connexion a réussi,
  • Faux dans le cas contraire. La fonction ErreurInfo permet d'obtenir plus de renseignements sur le problème rencontré.
<Périphérique> : Variable de type btlePériphérique
Nom de la variable de type btlePériphérique représentant le périphérique Bluetooth Low Energy avec lequel la connexion doit être établie. Ce périphérique a préalablement été détecté par la fonction BTLEListePériphérique.
<Délai d'attente> : Entier optionnel ou Durée optionnelle
Délai d'attente de connexion ou Timeout (en millisecondes). Passé ce délai, si la connexion n'a pas été effectuée, <Résultat> vaut Faux.
Si ce paramètre n'est pas spécifié, le délai d'attente de connexion par défaut est de 5 secondes.
Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de millisecondes,
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 1 s ou 10 ms).

Se connecter à un périphérique Bluetooth Low Energy (connexion non bloquante) Masquer les détails

BTLEConnecte(<Périphérique> , <Procédure WLangage>)
<Périphérique> : Variable de type btlePériphérique ou chaîne de caractères
  • Nom de la variable de type btlePériphérique représentant le périphérique Bluetooth Low Energy avec lequel la connexion doit être établie.
  • Identifiant du périphérique Bluetooth Low Energy avec lequel la connexion doit être établie (propriété Identifiant du type btlePériphérique).
    iPhone/iPad Attention : Le périphérique doit avoir été identifié par la fonction BTLEListePériphérique depuis le lancement de l'application.
Il n'est pas nécessaire que le périphérique soit accessible au moment de l'appel : la connexion s'effectuera dès que le périphérique sera accessible. La procédure sera appelée chaque fois que le périphérique s'allume et/ou entre dans la zone de détection de l'appareil.
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage (également nommée "callback") appelée lors de la connexion au périphérique Bluetooth Low Energy.
Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Périphérique>, <Résultat>)
où :
  • <Périphérique> est une variable de type btlePériphérique correspondant au périphérique Bluetooth connecté.
  • <Résultat> est une variable de type booléen :
    • Vrai si la connexion a réussi,
    • Faux dans le cas contraire. La fonction ErreurInfo permet d'obtenir plus de renseignements sur le problème rencontré.
Remarques
Android

Permissions requises

L'utilisation de cette fonction entraîne la modification des permissions requises par l'application.
Permission requise : BLUETOOTH.
Cette permission permet aux applications de se connecter à des services Bluetooth.
Liste des exemples associés :
WM Bluetooth 4 Exemples multiplateforme (WINDEV Mobile) : WM Bluetooth 4
[ + ] Cet exemple vous montre comment utiliser les fonctions Bluetooth Low Energy (Bluetooth LE) : BTLExxx.

Il s'agit d'une application permettant de rechercher les périphériques BTLE à proximité, s'y connecter, et intéragir avec les services proposés.
Classification Métier / UI : Code métier
Composante : wd290android.aar
Version minimum requise
  • Version 21
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 26/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale