PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Divers
  • Permissions requises
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
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,
  • Versions 23 et supérieures
    l'indication directe de la durée (par exemple 1 s ou 10 ms).
    Nouveauté 23
    l'indication directe de la durée (par exemple 1 s ou 10 ms).
    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> : Chaîne de caractères (avec ou sans guillemets)
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

Divers

  • Android Les fonctions WLangage Bluetooth Low Energy sont disponibles uniquement sur les appareils disposant d’une version d’Android supérieure ou égale à la version 4.3 (api level 18).
    • Si la fonction est utilisée avec une version antérieure du système, une erreur fatale sera déclenchée.
    • Pour connaître la version du système Android sur laquelle s’exécute l’application, utilisez la fonction SysVersionAndroid.
  • iPhone/iPad Les fonctions WLangage Bluetooth Low Energy sont disponibles uniquement à partir de iOS 9.
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.
Composantes
Android wd230android.jar
Version minimum requise
  • Version 21
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire