PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Divers
  • Permissions requises
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Liste les périphériques Bluetooth Low Energy actuellement accessibles.
Exemple
BTLEListePériphérique(ProcDétectePériph)
...
 
PROCÉDURE INTERNE ProcDétectePériph(UnPériph)
// Traitement de UnPériph
FIN
Syntaxe
BTLEListePériphérique(<Procédure WLangage> [, <Délai d'attente>])
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage (également nommée "callback") appelée pour lister les périphériques. Cette procédure permet de récupérer les informations sur périphériques trouvés.
Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Périphérique>, <Intensité du signal>)

où :
  • <Périphérique> est une variable de type btlePériphérique correspondant au périphérique détecté.
  • Versions 22 et supérieures
    <Intensité du signal> est un entier correspondant à l'intensité du signal exprimée en décibel par mètre.
    Nouveauté 22
    <Intensité du signal> est un entier correspondant à l'intensité du signal exprimée en décibel par mètre.
    <Intensité du signal> est un entier correspondant à l'intensité du signal exprimée en décibel par mètre.
Si la procédure renvoie Faux, l'analyse des périphériques accessibles sera immédiatement stoppée.
<Délai d'attente> : Entier optionnel ou Durée optionnelle
Délai d'attente de la recherche (en secondes). Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de secondes,
  • une variable de type Durée,
  • Versions 23 et supérieures
    l'indication directe de la durée (par exemple 1 s).
    Nouveauté 23
    l'indication directe de la durée (par exemple 1 s).
    l'indication directe de la durée (par exemple 1 s).
Si ce paramètre n'est pas spécifié, le délai d'attente par défaut est de 10 secondes.
Remarques

Divers

Si la fonction BTLEListePériphérique est appelée alors qu'une analyse est déjà en cours, l'analyse précédente sera stoppée et une nouvelle analyse sera lancée.
Android

Permissions requises

L’utilisation de cette fonction entraîne la modification des permissions requises par l’application.
Permissions requises :
  • BLUETOOTH : cette permission permet aux applications de se connecter à des services bluetooth.
  • Versions 25 et supérieures
    ACCESS_COARSE_LOCATION : cette permission permet à une application d'accéder à un emplacement indéfini (Cell-ID, WiFi).
    Nouveauté 25
    ACCESS_COARSE_LOCATION : cette permission permet à une application d'accéder à un emplacement indéfini (Cell-ID, WiFi).
    ACCESS_COARSE_LOCATION : cette permission permet à une application d'accéder à un emplacement indéfini (Cell-ID, WiFi).
Spécificité Android 10 : Une nouvelle permission a été mise en place dans Android 10 pour les fonctions permettant la localisation de l'appareil : ACCESS_BACKGROUND_LOCATION.
Cette permission permet d'autoriser l'utilisation de la fonction lorsque l'application est en arrière-plan.
Lorsque cette permission est ajoutée à l'application, une fenêtre permet à l'utilisateur de :
  • accepter l'accès à la position de l'appareil avec l'application en arrière-plan,
  • limiter l'accès à la position à l'application active,
  • refuser l'accès à la position.
L'utilisateur peut également modifier son autorisation à posteriori dans les réglages de Android.
Spécificité Android 11 : L'utilisation de cette fonction nécessite la mise en place de la permission : ACCESS_BACKGROUND_LOCATION permettant la localisation de l'appareil.
Cette permission permet d'autoriser l'utilisation de la fonction lorsque l'application est en arrière-plan.
Si l'application nécessite la localisation en arrière-plan, il faut :
  • Ajouter manuellement la permission "ACCESS_BACKGROUND_LOCATION" dans l'assistant de génération de l'application Android.
  • Demander explicitement la permission de localisation en arrière-plan à l'utilisateur avec la fonction PermissionDemande. Par exemple :
    PermissionDemande(permLocalisationEnArrièrePlan, Callback)
    PROCÉDURE INTERNE Callback(p est une Permission)
    SI p.Accordé ALORS
    // Utilisation possible des fonctions nécessitant la localisation en arrière-plan
    FIN
    FIN
Une fenêtre permet à l'utilisateur de :
  • accepter l'accès à la position de l'appareil avec l'application en arrière-plan,
  • limiter l'accès à la position à l'application active,
  • refuser l'accès à la position.
L'utilisateur peut également modifier son autorisation à posteriori dans les réglages de Android.
Remarques :
  • Respectez les spécifications Google concernant les applications utilisant la localisation en arrière-plan. Pour plus de détails, consultez https://support.google.com/googleplay/android-developer/answer/9799150. Si ces conditions ne sont pas remplies (notamment les conditions d'information de l'utilisateur), les applications pourront ne pas obtenir l'autorisation de publication sur Play Store.
  • La demande de permission de localisation en arrière-plan ne doit être effectuée que si la permission de localisation a été accordée. Dans le cas contraire, la fonction PermissionDemande échouera.
  • Si le choix de l'utilisateur lors de la demande de permission de localisation en arrière-plan est plus restrictif que le choix effectué lors de la demande de permission de localisation, l'application sera automatiquement relancée.
  • Sur les appareils en version inférieure à Android 10, si la permission de localisation a été accordée à l'application, la demande de permission de localisation en arrière-plan sera accordée sans affichage de fenêtre.
Classification Métier / UI : Code métier
Composante : wd260android.aar
Version minimum requise
  • Version 21
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire