DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Bluetooth
  • Radio visible et demande de connexion
  • Permissions requises
  • Limitation
  • Application en arrière-plan : Spécificité à partir de Android 10
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
BTChangeVisibilité (Fonction)
En anglais : BTChangeVisibility
Change la visibilité d'une radio Bluetooth.
Remarque : Une radio Bluetooth correspond à un émetteur Bluetooth. Cet émetteur peut par exemple correspondre à une clé USB Bluetooth, ou être un élément intégré au poste (par exemple dans le cas d'un portable).
Android Attention : Les fonctions Bluetooth ne sont pas disponibles dans l'émulateur Android.
Exemple
Etats et RequêtesWindowsCode Utilisateur (MCU)Ajax
bVisible est un booléen
// Identifiant des radios Bluetooth listés dans un champ Table
nIdRadio est un entier
nIdRadio = TABLE_Radios.COL_ID[TABLE_Radios]
// Teste si la radio sélectionnée est visible
bVisible = BTEstVisible(nIdRadio)
// Affichage
SI bVisible = Vrai ALORS
Trace("Visible")
SINON
Trace("Non visible")
FIN
// Changement de la visibilité
BTChangeVisibilité(nIdRadio, PAS bVisible)
Syntaxe
Etats et RequêtesWindowsCode Utilisateur (MCU)Ajax

Syntaxe utilisable sous Windows Masquer les détails

<Résultat> = BTChangeVisibilité(<Identifiant de la radio> , <Nouvel état>)
<Résultat> : Booléen
  • Vrai si le changement de visibilité a réussi,
  • Faux dans le cas contraire. La fonction ErreurInfo permet d'obtenir plus de renseignements sur le problème rencontré.
<Identifiant de la radio> : Entier
Identifiant de la radio Bluetooth à manipuler. Cet identifiant est retourné par la fonction BTListeRadio.
<Nouvel état> : Booléen
  • Vrai pour que la radio devienne visible,
  • Faux pour que la radio soit cachée.
Android

Syntaxe utilisable sur Android Masquer les détails

<Résultat> = BTChangeVisibilité(<Nouvel état> [, <Durée>])
<Résultat> : Booléen
  • Vrai si le changement de visibilité a réussi,
  • Faux dans le cas contraire. La fonction ErreurInfo permet d'obtenir plus de renseignements sur le problème rencontré.
<Nouvel état> : Booléen
  • Vrai pour que la radio devienne visible,
  • Faux pour que la radio soit cachée.
Android Il n'est pas possible de désactiver la visibilité par programmation. Cette désactivation est uniquement temporaire.
<Durée> : Entier optionnel ou Durée optionnelle
Durée en secondes durant laquelle le périphérique doit être rendu visible. Ce paramètre doit être compris entre 1 et 300 secondes. Par défaut, la durée de visibilité est de 120 secondes.
Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de secondes,
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 1 s).
Remarques

Radio visible et demande de connexion

Une radio Bluetooth visible accepte automatiquement les demandes de connexion. Lorsque la fonction BTChangeVisibilité permet de rendre la radio visible, l'appel à la fonction BTChangeConnectivité est automatiquement réalisé.
Android Sous Android, la visibilité de l'appareil vis-à-vis des autres périphériques Bluetooth est toujours temporaire (5 minutes maximum). Si la fonction BTChangeVisibilité est utilisée pour rendre l'appareil visible, une boîte de dialogue système sera affichée pour demander confirmation à l'utilisateur.
Remarque : Cette boîte de dialogue est imposée par le système Android et ne peut donc pas être évitée.
Boite de confirmation Android
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.
Windows

Limitation

Seule la pile bluetooth Microsoft est supportée par cette fonction. Pour connaître la pile utilisée, utilisez la fonction BTPile.
Pour plus de détails sur les clés supportées, consultez Quelles piles utiliser ?
Android

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.
La fonction BTChangeVisibilité peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.
Conseils :
  • Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
  • Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.
Composante : wd290com.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/06/2023

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