Ajoute un nouveau réseau à la liste des réseaux Wi-Fi configurés de l'appareil. La fonction
WiFiConnecte permet ensuite de connecter l'appareil au réseau Wi-Fi ajouté.
Remarque : L'accès Wi-Fi n'est pas disponible dans l'émulateur Android.
Versions 18 et supérieures
Nouveauté 18
Identifiant est une chaîne
Identifiant = WiFiAjouteRéseau("SSID", "BSSID", wifiSécuritéWPA, "mdp", Vrai)
SI Identifiant <> " " ALORS
WiFiConnecte(Identifiant)
FIN
Syntaxe
<Résultat> = WiFiAjouteReseau(<SSID> , <BSSID> , <Sécurité> [, <Clé> [, <Permanent>]])
<Résultat> : Chaîne de caractères
- Identifiant réseau du nouveau réseau.
- Chaîne vide si le réseau n'a pas pu être créé. La fonction ErreurInfo permet d'obtenir plus de renseignements sur le problème rencontré.
Remarque : Si le réseau ajouté correspond à un réseau déjà configuré sur l'appareil, <Résultat>correspond à l'identifiant du réseau existant.
<SSID> : Chaîne de caractères
SSID (Service Set Identifier) du réseau Wi-Fi.
<BSSID> : Chaîne de caractères
BSSID (Basic Service Set Identifier) du point d'accès associé au réseau.
<Sécurité> : Constante de type chaîne de caractères
Type de sécurité utilisé par le réseau Wi-Fi : | |
| wifiSécuritéAucune | Aucune sécurité n'est utilisée. |
| wifiSécuritéWEP | Sécurité basée sur une clé WEP (Wired Equivalent Privacy) |
| wifiSécuritéWPA | Sécurité utilisant le mécanisme WPA (Wi-Fi Protected Access). |
| wifiSécuritéWPA2 | Sécurité utilisant le mécanisme WPA2 (Wi-Fi Protected Access). |
| wifiSécuritéWPA_EAP | Sécurité utilisant les mécanismes WPA (Wi-Fi Protected Access) et EAP (Extensible Authentification Protocol). |
| wifiSécuritéIEEE8021X | Sécurité utilisant la norme IEEE 802.1x. |
<Clé> : Chaîne de caractères optionnelle
Clé utilisée pour se connecter au réseau sécurisé. Si le protocole de sécurité spécifié est de type WPA ou WPA2, la clé est obligatoire.
<Permanent> : Booléen optionnel
Indique si l'ajout du réseau est permanent : - Vrai : le réseau ajouté sera mémorisé de façon permanente sur l'appareil.
- Faux (valeur par défaut) : le réseau ajouté ne sera pas conservé lors du prochaine redémarrage de l'appareil.
Remarques
Cas particuliers
- Si le réseau ajouté est mémorisé de façon permanente sur l'appareil (paramètre <Permanent> à Vrai), les identifiants attribués à chacun des réseaux peuvent être modifiés après l'exécution de la fonction WiFiAjouteRéseau. Utilisez la fonction WiFiListeRéseau pour connaître les nouveaux identifiants.
- Pour supprimer un réseau de la liste des réseaux configurés de l'appareil, utilisez la fonction WiFiSupprimeRéseau.
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.
Liste des exemples associés :
|
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 : wd270android.jar