RéseauMobileInfoConnexion (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions de gestion du téléphone

Informations sur la connexion WiFi

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

RéseauMobileInfoConnexion (Fonction)

En anglais : MobileNetworkConnectionInfo

Renvoie les informations demandées concernant la connexion actuelle aux données sur le réseau mobile.

Remarque : Cette fonction n'est pas utilisable dans le simulateur et renverra 0 dans ce cas.

Exemple

// Activation du Wi-Fi si l'intensité du signal est suffisante pour l'accès aux données
// via le réseau mobile
SI Val(RéseauMobileInfoConnexion(réseauSignalGSM)) <= 20 _ET_ WiFiEtat() <> wifiActif ALORS
SI OuiNon("L'intensité du signal GSM est insuffisante. Activer le Wi-Fi ?") ALORS
WiFiActive()
FIN
FIN

Syntaxe

<Résultat> = RéseauMobileInfoConnexion(<Type d'information>)

<Résultat> : Chaîne de caractères ou constante de type Entier

Information demandée.
Si plusieurs types d'informations sont demandés, chaque type d'information est séparé par un Retour Chariot (RC).
L'ordre dans lequel sont renvoyées les informations (si elles sont demandées) est le suivant :
<Type de réseau>
<Opérateur>
<Signal GSM>
<Itinérance>
<Mode avion>

<Type d'information> : Constante de type Entier

Information demandée :
réseauItinérance Mode d'itinérance des données.
Si cette information est demandée, <Résultat> vaut :
"1" si la connexion actuelle utilise l'itinérance des données (roaming)
"0" dans le cas contraire.
Cette constante n'est pas disponible.
réseauModeAvion Gestion du mode avion.
Si cette information est demandée, <Résultat> vaut :
"1" si l'appareil est en mode avion.
"0" dans le cas contraire.
Cette constante n'est pas disponible.
réseauOpérateur Nom de l'opérateur réseau utilisé.
Selon le type de réseau ou si le mode avion est activé, cette information peut ne pas être renseignée.
En l'absence de carte SIM, cette information peut correspondre à un nom d'opérateur si le téléphone est "Sim-locké".
Cette constante n'est pas disponible.
réseauSignalGSM Intensité du signal GSM comprise entre "0" (pas de signal) et "100" (signal optimal).
Cette constante n'est pas disponible.
réseauType Type de réseau utilisé pour l'accès aux données sur le réseau mobile.
Mode d'itinérance des données.
Si cette information est demandée, <Résultat> vaut une constante de type entier :
réseau2G : Réseau 2G
réseauEdge : Réseau Edge
réseau3G : Réseau 3G
réseau4G : Réseau 4G
réseau5G : Réseau 5G
réseauInconnu : Réseau inconnu (ou absence de carte SIM).

Remarques

Informations sur la connexion WiFi

Pour récupérer des informations sur la connexion WiFi, utilisez la fonction WifiInfoConnexion.

Permissions requises
L'utilisation de cette fonction entraîne la modification des permissions requises par l'application.
La permission ACCESS_COARSE_LOCATION est ajoutée : cette permission permet à une application d'accéder à un emplacement indéfini (Cell-ID, WiFi).

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 :

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 : wd300android.aar

Voir Aussi

Version minimum requise

Version 17

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/09/2023

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