@capgo/capacitor-wifi

Aperçu

Gérez la connectivité WiFi de votre application Capacitor

Commencez par addNetwork() et les autres méthodes principales listées ci-dessous.

Support des plateformes

Plateforme	Support	Notes
iOS	Oui	Natif
Android	Oui	Natif
Le Web	Non	Protéger avec Capacitor.getPlatform()

Fonctionnalités clés

• addNetwork - Affiche une boîte de dialogue système pour ajouter un réseau Wi-Fi à l'appareil. Sur Android SDK 30+, cela ouvre les paramètres Wi-Fi du système avec le réseau pré-rempli. Sur iOS, cela se connecte directement au réseau.
• connect - Se connecte à un réseau Wi-Fi. Sur Android, cela crée une connexion temporaire qui ne route pas le trafic via le réseau par défaut. Définissez autoRouteTraffic sur true pour lier le trafic de l'app au réseau connecté (utile pour les points d'accès locaux ou hébergés sur l'appareil). Pour une connexion persistante sur Android, utilisez plutôt addNetwork(). Sur iOS, cela crée une connexion persistante.
• disconnect - Se déconnecte du réseau Wi-Fi actuel. Sur iOS, cela ne déconnecte que les réseaux qui ont été ajoutés via ce plugin.
• getAvailableNetworks - Récupérer la liste des réseaux Wi-Fi disponibles lors du dernier scan. Disponible uniquement sur Android.

API public

Méthode	Description
addNetwork	Afficher une boîte de dialogue système pour ajouter un réseau Wi-Fi à l'appareil. Sur Android SDK 30+, cela ouvre les paramètres Wi-Fi système avec le réseau prérempli. Sur iOS, cela se connecte directement au réseau.
connect	Connectez-vous à un réseau Wi-Fi. Sur Android, cela crée une connexion temporaire qui ne route pas le trafic via le réseau par défaut. Définissez autoRouteTraffic sur true pour lier le trafic de l'application au réseau connecté (utile pour les points d'accès locaux ou hébergés sur l'appareil). Pour une connexion persistante sur Android, utilisez plutôt addNetwork(). Sur iOS, cela crée une connexion persistante.
disconnect	Se déconnecter du réseau Wi-Fi actuel. Sur iOS, la déconnexion ne concerne que les réseaux ajoutés via ce plugin.
getAvailableNetworks	Récupérer la liste des réseaux Wi-Fi disponibles lors du dernier scan. Disponible uniquement sur Android.
getIpAddress	Récupérez l'adresse IP actuelle de l'appareil. Disponible sur Android et iOS.
getRssi	Récupérez l'indicateur de force du signal reçu (RSSI) du réseau actuel en dBm. Disponible uniquement sur Android.
getSsid	Récupérez l'identifiant du service (SSID) du réseau actuel. Disponible sur Android et iOS.
getWifiInfo	Récupérez des informations complètes sur le réseau WiFi connecté. Cette méthode fournit des détails réseau incluant le SSID, le BSSID, l'adresse IP, la fréquence, la vitesse de liaison et la force du signal en un seul appel. Sur iOS, certains champs peuvent ne pas être disponibles et seront undefined.
isEnabled	Vérifiez si le Wi-Fi est activé sur l'appareil. Disponible uniquement sur Android.
startScan	Lancez la recherche de réseaux Wi-Fi. Disponible uniquement sur Android. Les résultats sont transmis via l'écouteur d'événement ‘networksScanned’. Remarque : peut échouer en raison d'une limitation système ou de problèmes matériels.
checkPermissions	Vérifiez l'état actuel des permissions de localisation. L'autorisation de localisation est requise pour les opérations Wi-Fi sur les deux plateformes.
requestPermissions	Demandez l'autorisation de localisation à l'utilisateur. L'autorisation de localisation est requise pour les opérations Wi-Fi sur les deux plateformes.
addListener	Ajoutez un écouteur pour l'événement ‘networksScanned’. Disponible uniquement sur Android. Cet événement est déclenché lorsque les résultats du scan Wi-Fi sont disponibles.
removeAllListeners	Supprimez tous les écouteurs de ce plugin.
getPluginVersion	Récupérez la version du plugin natif.

Source de vérité

Cette référence est synchronisée depuis src/definitions.ts dans capacitor-wifi.

Continuer avec @capgo/capacitor-wifi

Si vous utilisez @capgo/capacitor-wifi pour planifier le travail sur les plugins natifs, connectez-l’à Utiliser @capgo/capacitor-wifi pour la fonctionnalité native de la page Utiliser @capgo/capacitor-wifi, Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Ajout ou mise à jour de plugins, et Alternatives aux plugins Ionic Enterprise pour le workflow produit dans Alternatives aux plugins Ionic Enterprise.