|
|
|
|
|
- Cas particuliers
- Limitations
- Permissions requises
- Threads et sablier
BTListePériphérique (Fonction) En anglais : BTListDevice Liste les périphériques Bluetooth accessibles. sChaîneTmp est une chaîne sListePériphs est une chaîne // Liste les périphériques Sablier(Vrai) sListePériphs = BTListePériphérique() Sablier(Faux) // Vide le champ Table où sont listés les périphériques TableSupprimeTout(TABLE_Appareils) // Remplit le champ Table SI sListePériphs <> "" ALORS POUR TOUTE CHAÎNE sChaîneTmp DE sListePériphs SÉPARÉE PAR RC TableAjoute(TABLE_Appareils, sChaîneTmp) FIN SINON Info(ErreurInfo(errComplet)) FIN Syntaxe
<Résultat> = BTListePériphérique([<Niveau de détail> [, <Type des éléments à  lister> [, <Timeout> [, <Identifiant de la radio>]]]])
<Résultat> : Chaîne de caractères - Liste des périphériques Bluetooth disponibles,
- Chaîne vide ("") en cas d'erreur. La fonction ErreurInfo permet d'obtenir plus de détails sur le problème rencontré.
Cette liste est de la forme : - en mode simple :
<Identifiant Périphérique 1> + TAB + <Adresse MAC 1> + TAB + <Nom 1> + RC + ... + RC + <Identifiant Périphérique N> + TAB + <Adresse MAC N> + TAB + <Nom N> - en mode détaillé :
<Identifiant Périphérique 1> + TAB + <Adresse MAC 1> + TAB + <Nom 1> + TAB + <Identifiant Classe 1> + TAB + <Connecté 1> + TAB + <Mémorisé 1> + TAB + <Authentifié 1> + TAB + <Date Vue 1> + TAB + <Date utilisé 1> + RC + ... + RC + <Identifiant Périphérique N> + TAB + <Adresse MAC N> + TAB + <Nom N> + TAB + <Identifiant Classe N> + TAB + <Connecté N> + TAB + <Mémorisé N> + TAB + <Authentifié N> + TAB + <Date vue N> + TAB + <Date utilisé N>
Les différentes informations obtenues sont les suivantes : - <Identifiant Périphérique> : Identifiant du périphérique, à utiliser dans les fonctions Bluetooth manipulant des périphériques.
- <Adresse Mac> : Adresse physique du périphérique.
- <Nom> : Nom retourné par le périphérique (peut être une chaîne vide).
- <Identifiant Classe> : Classe du périphérique (entier sur 32 permettant d'obtenir des informations sur le type du périphérique). Cette classe peut correspondre à une des constantes suivantes :
- btCoD_AccèsRéseau
- btCoD_AudioVidéo
- btCoD_pers
- btCoD_Image
- btCoD_Inconnu
- btCoD_Jouet
- btCoD_Ordinateur
- btCoD_Périphérique
- btCoD_Téléphone
- btCoD_Vêtement
- <Connecté> : 1 si le périphérique est actuellement "connecté" au poste en cours, 0 dans le cas contraire.
![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) Cette information n'est pas gérée et correspondra toujours à 0. - <Mémorisé> : 1 si le périphérique est actuellement "mémorisé" par le gestionnaire Bluetooth du poste en cours, 0 dans le cas contraire.
![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) Cette information n'est pas gérée et correspondra toujours à 0. - <Authentifié> : 1 si le périphérique est actuellement authentifié auprès du poste en cours, 0 dans le cas contraire.
- <Date vue> : Date et heure à laquelle le périphérique a été vu pour la dernière fois par le poste en cours. Cette date est au format JJMMAAAAHHMMSS. Cette information est fournie uniquement pour les périphériques mémorisés.
![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) Cette information n'est pas gérée et correspondra toujours à chaîne vide (""). - <Date utilisé> : Date et heure à laquelle le périphérique a été utilisé pour la dernière fois. Cette date est au format JJMMAAAAHHMMSS. Cette information est fournie uniquement pour les périphériques mémorisés.
![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) Cette information n'est pas gérée et correspondra toujours à chaîne vide ("").
<Niveau de détail> : Constante optionnelle de type Entier Niveau de détail du résultat :
| | btListeDétaillée | <Résultat> contient la liste des périphériques en mode détaillé. | btListeSimple (Valeur par défaut) | <Résultat> contient la liste des périphériques en mode simple. |
<Type des éléments à lister> : Constante ou combinaison de constantes de type entier optionnelle État des périphériques à sélectionner :
| | btEtatAuthentifié | Propose les périphériques authentifiés. | btEtatConnecté | Propose les périphériques connectés. | btEtatInconnu | Propose les périphériques inconnus. | btEtatMémorisé | Propose les périphériques mémorisés. | btEtatTous (Valeur par défaut) | Propose tous les périphériques. |
<Timeout> : Entier optionnel Timeout en secondes (compris entre 1 et 60) de la recherche des périphériques. Par défaut, ce paramètre a pour valeur 10. <Identifiant de la radio> : Entier optionnel Identifiant de la radio Bluetooth à manipuler. Cet identifiant est retourné par la fonction BTListeRadio. Remarques - Un périphérique authentifié est nécessairement mémorisé (l'inverse n'est pas vrai).
- Le listage des périphériques est effectué en interrogeant l'environnement jusqu'au <Timeout> de la fonction. Dans cet intervalle de temps, il est possible que les périphériques n'aient pas le temps nécessaire pour communiquer leur identité. Il suffit d'utiliser ensuite la fonction BTInfoPériphérique pour obtenir les informations manquantes.
Composante : wd300com.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|