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> : 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

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.
Classification Métier / IHM : Code métier
Composante : wd240android.jar
Version minimum requise
  • Version 21
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire