Guide
Tutoriel sur le Wi-Fi
Utilisation de @capgo/capacitor-wifi
Plugin Wi-Fi pour gérer la connectivité Wi-Fi du dispositif.
Installer
bun add @capgo/capacitor-wifi
bunx cap sync
Ce que ce plugin expose
addNetwork- Afficher un dialogue système pour ajouter un réseau Wi-Fi au dispositif. 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 n'envoie pas les données par défaut par le réseau. Définir autoRouteTraffic sur true pour lier le trafic de l'application au réseau connecté (utile pour les APs hôte local/du dispositif). Pour une connexion persistante sur Android, utilisez addNetwork() à la place. Sur iOS, cela crée une connexion persistante.disconnect- Se déconnecter du réseau Wi-Fi actuel. Sur iOS, cela se déconnecte uniquement des réseaux ajoutés via ce plugin.getAvailableNetworks- Obtenir une liste des réseaux Wi-Fi disponibles à partir de la dernière scan. Disponible uniquement sur Android.
Exemple d'utilisation
addNetwork
Afficher un dialogue système pour ajouter un réseau Wi-Fi au dispositif. 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 } 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 par défaut. Définissez autoRouteTraffic sur true pour lier le trafic de l'application au réseau connecté (utile pour les APs hôte local/ appareil). Pour une connexion persistante sur Android, utilisez addNetwork() à la place. 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, cela ne se déconnecte que des réseaux ajoutés via ce plugin.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.disconnect();
getAvailableNetworks
Obtenir la liste des réseaux Wi-Fi disponibles à partir de la dernière scan. Seulement disponible 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/
- Documentation : /docs/plugins/wifi/
Continuez à partir de l'utilisation de @capgo/capacitor-wifi
Si vous utilisez L'utilisation de @capgo/capacitor-wifi pour planifier le tableau de bord et les opérations de API, connectez-l’avec @capgo/capacitor-wifi pour les détails d'implémentation dans @capgo/capacitor-wifi, Prise en main pour les détails d'implémentation dans Prise en main, Vue d'ensemble 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 de API pour les détails d'implémentation dans Clés de API.