Guide
Comment utiliser le WiFi dans Capacitor
Tester sur l'appareil
Téléchargez l'application Capgo, puis scannez le QR code.
Utilisation de @capgo/capacitor-wifi
Plugin WiFi pour gérer la connectivité WiFi de l'appareil.
Installer
bun add @capgo/capacitor-wifi
bunx cap sync
Ce que ce plugin expose
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 système avec le réseau pré-rempli. Sur iOS, cela se connecte directement au réseau.connect- Se connecter à 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. Réglez autoRouteTraffic sur true pour lier le trafic de l'app au réseau connecté (utile pour les points d'accès locaux/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, cela ne déconnecte 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.
Exemple d'utilisation
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.
import { CapacitorWifi, NetworkSecurityType } from '@capgo/capacitor-wifi';
await CapacitorWifi.addNetwork({
ssid: 'MyNetwork',
password: 'mypassword',
isHiddenSsid: false,
securityType: NetworkSecurityType.WPA2_PSK
});
connect
Se connecter à 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.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.connect({
ssid: 'MyNetwork',
password: 'mypassword',
autoRouteTraffic: true // Android only: route app traffic through this network
});
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.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.disconnect();
getAvailableNetworks
Récupérer la liste des réseaux Wi-Fi disponibles lors du dernier scan. Disponible uniquement sur Android.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});
Référence complète
- GitHub : https://github.com/Cap-go/capacitor-wifi/
- Docs : /docs/plugins/wifi/
Continuer après avoir utilisé @capgo/capacitor-wifi
Si vous utilisez Utiliser @capgo/capacitor-wifi pour planifier les opérations du dashboard et de API, connectez-l’avec @capgo/capacitor-wifi pour le détail d’implémentation dans @capgo/capacitor-wifi, Prise en main pour les détails d'implémentation dans Getting Started Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'Introduction, et Clés API pour les détails d'implémentation dans les clés API.