DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions WiFi
  • Cas particuliers
  • 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
WiFiDétectePointAccès (Fonction)
En anglais : WiFiDetectAccessPoint
Lance la détection des points d'accès Wi-Fi actuellement accessibles depuis l'appareil.
AndroidWidget Android Remarques :
  • Pour ajouter le réseau associé à un point d'accès à la liste des réseaux configurés de l'appareil, utilisez la fonction WiFiAjouteRéseau.
  • L'accès Wi-Fi n'est pas disponible dans l'émulateur Android.
Exemple
TitreSuivant("Détection des points d'accès Wi-Fi")
ListePoint est une chaîne
sSSID est une chaîne
sBSSID est une chaîne
ListePoint = WiFiDétectePointAccès()
POUR TOUTE CHAÎNE PointAcces DE ListePoint SÉPARÉE PAR RC
sSSID = ExtraitChaîne(PointAcces, 2, TAB)
sBSSID = ExtraitChaîne(PointAcces, 3, TAB)
...
FIN
Syntaxe
<Résultat> = WiFiDétectePointAccès([<Délai>])
<Résultat> : Chaîne de caractères
  • Liste des points d'accès Wi-Fi détectés séparés par RC (Retour-Chariot),
  • Chaîne vide ("") si aucun point d'accès Wi-Fi n'a été détecté. La variable ErreurDétectée permet de tester si une erreur s'est produite durant la détection des points d'accès. La fonction ErreurInfo permet d'obtenir plus de renseignements sur le problème rencontré.
Pour chaque réseau, une série d'informations est retournée au format suivant :
<Identifiant> + TAB + <SSID> + TAB + <BSSID> +
TAB + <Sécurité> + TAB + <Puissance du signal>
où :
  • <Identifiant>  : Identifiant du réseau associé au point d'accès, chaîne vide ("") si le point d'accès ne correspond à aucun réseau configuré sur l'appareil.
  • <SSID> : SSID (Service Set Identifier) du réseau Wi-Fi associé au point d'accès.
  • <BSSID> : BSSID (Basic Service Set Identifier) du point d'accès
  • <Sécurité> : Type de sécurité utilisé par le réseau Wi-Fi :
    wifiSécuritéAucuneAucune sécurité n'est utilisée.
    wifiSécuritéIEEE8021XSécurité utilisant la norme IEEE 802.1x.
    wifiSécuritéWEPSécurité basée sur une clé WEP (Wired Equivalent Privacy)
    wifiSécuritéWPA2Sécurité utilisant le mécanisme WPA2 (Wi-Fi Protected Access).
    wifiSécuritéWPASécurité utilisant le mécanisme WPA (Wi-Fi Protected Access).
    wifiSécuritéWPA_EAPSécurité utilisant les mécanismes WPA (Wi-Fi Protected Access) et EAP (Extensible Authentification Protocol).
  • <Puissance du signal> : Puissance du signal exprimée en dBm (décibel par milliwatt).
<Délai> : Entier optionnel ou Durée optionnelle
Durée maximale de la détection en centièmes de seconde.
  • Si ce délai est écoulé avant la fin de la détection, une erreur se produit.
  • Si ce délai n'est pas spécifié ou vaut 0, aucune limitation de durée ne sera appliquée.
Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de centièmes de seconde,
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 1 s ou 10 ms).
Remarques

Cas particuliers

  • La liste des points d'accès renvoyée par la fonction WiFiDétectePointAccès est triée par ordre de puissance du signal (du signal le plus puissant au moins puissant).
  • AndroidWidget Android Si la fonction est exécutée par le thread principal de l'application, un sablier (jauge infinie) sera affiché durant la détection des point d'accès. Pour spécifier le message à afficher dans le sablier, utilisez la fonction TitreSuivant juste avant l'appel à la fonction WiFiDétectePointAccès.
  • A partir d'Android 6.0 : La localisation doit être activée sur l'appareil. Dans le cas contraire, la fonction retournera une liste vide. La fonction GPSEtat permet de savoir si la localisation est active ou non.
AndroidWidget Android

Permissions requises

L'utilisation de cette fonction entraîne la modification des permissions requises par l'application.
Permissions requises :
  • ACCESS_WIFI_STATE : Permet aux applications d'accéder à des informations concernant les réseaux Wi-Fi.
  • CHANGE_WIFI_STATE : Permet aux applications de modifier l'état de connectivité Wi-Fi.
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.
Liste des exemples associés :
WM Système Exemples multiplateforme (WINDEV Mobile) : WM Système
[ + ] Cette application est un exemple didactique montrant quelques unes des fonctionnalités de WINDEV Mobile pour Android/iOS.
Les fonctions système utilisées sont :
- NFC
- Champ Multimédia
- Luminosité
- Volume
- WIFI
- Bluetooth
- Toast
- Boussole
- Accéléromètre
- Champ caméra
- LED
- Vibrations
- Notifications
- Fonctions de dessin
- Internet
Composante : wd290com.dll
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 22/06/2023

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