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
Renvoie l'état actuel de la connexion avec un périphérique Bluetooth Low Energy ou demande à être prévenu en cas de changement de l'état de la connexion.
Remarque : Les fonctions Bluetooth ne sont pas disponibles dans l'émulateur Android.
Exemple
monPériph est un btlePériphérique
BTLEConnecte(monPériph)
...
SELON BTLEEtatConnexion(monPériph)
CAS btleEtatConnecté
// Traitement
AUTRES CAS
...
FIN
Syntaxe

Connaître l'état actuel de la connexion Masquer les détails

<Résultat> = BTLEEtatConnexion(<Périphérique>)
<Résultat> : Constante de type Entier
Etat de la connexion :
btleEtatConnectéL'appareil est connecté au périphérique Bluetooth spécifié.
btleEtatDéconnectéL'appareil n'est pas connecté au périphérique Bluetooth spécifié.
<Périphérique> : Variable de type btlePériphérique
Nom de la variable de type btlePériphérique correspondant au périphérique à manipuler.

Activer la notification des changements d'activation du Bluetooth Masquer les détails

BTLEEtatConnexion(<Procédure WLangage>)
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage (appelée "callback") appelée lorsque l'état de connexion du Bluetooth change sur l'appareil. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure> (<Périphérique>, <Etat>)
où :
  • <Périphérique> est une variable de type btlePériphérique correspondant au périphérique Bluetooth dont on récupère l'état.
  • <Etat> est une constante de type entier correspondant à l'état de la connexion du Bluetooth sur l'appareil :
    btleEtatConnectéL'appareil est connecté au périphérique Bluetooth spécifié.
    btleEtatDéconnectéL'appareil n'est pas connecté au périphérique Bluetooth spécifié.
Il n'est pas nécessaire de passer des paramètres à cette procédure. En effet, ces paramètres sont renseignés automatiquement à chaque appel.
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.


Versions nécessaires
  • Android Applications 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/iPadWidget IOSMac Catalyst Applications iOS :
    Les fonctions WLangage Bluetooth Low Energy sont disponibles uniquement sur les appareils disposant d'iOS 9.
  • Windows Applications WINDEV :
    • Les fonctions WLangage Bluetooth Low Energy sont disponibles uniquement sur :
      • les PC gérant le Bluetooth Low Energy version 5 minimum.
      • les PC utilisant une clé Bluetooth gérant le Bluetooth Low Energy version 5 minimum.
    • Le gestionnaire de périphériques de Windows permet en cas de doute de contrôler la version du Bluetooth d'un poste de travail : https://support.microsoft.com/en-us/windows/what-bluetooth-version-is-on-my-pc-f5d4cff7-c00d-337b-a642-d2d23b082793
    • L'appairage doit être fait au niveau de Windows. Ainsi, la fonction BTLEListePériphérique ne permettra d'énumérer que les périphériques qui sont visibles et associés dans les réglages Bluetooth de Windows.
Classification Métier / UI : Code métier
Composante : wd290com.dll
Version minimum requise
  • Version 21
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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