Guida
Come usare il WiFi in Capacitor
Utilizzando @capgo/capacitor-wifi
Plugin WiFi per gestire la connettività WiFi del dispositivo.
Installa
bun add @capgo/capacitor-wifi
bunx cap sync
Funzionalità esposte dal plugin
addNetwork- Mostra un dialog di sistema per aggiungere una rete Wi-Fi al dispositivo. Su Android SDK 30+, apre le impostazioni WiFi di sistema con la rete precompilata. Su iOS, si connette direttamente alla rete.connect- Connettiti a una rete Wi-Fi. Su Android, crea una connessione temporanea che non instrada il traffico sulla rete di default. Imposta autoRouteTraffic a true per vincolare il traffico dell'app alla rete connessa (utile per AP locali/del dispositivo). Per una connessione persistente su Android, usa addNetwork(). Su iOS, crea una connessione persistente.disconnect- Disconnettiti dalla rete Wi-Fi corrente. Su iOS, si disconnette solo dalle reti aggiunte tramite questo plugin.getAvailableNetworks- Ottieni l'elenco delle reti Wi-Fi disponibili dall'ultima scansione. Disponibile solo su Android.
Esempio d'uso
addNetwork
Mostra un dialogo di sistema per aggiungere una rete Wi-Fi al dispositivo. Su Android SDK 30+, apre le impostazioni Wi-Fi di sistema con la rete precompilata. Su iOS, si connette direttamente alla rete.
import { CapacitorWifi, NetworkSecurityType } from '@capgo/capacitor-wifi';
await CapacitorWifi.addNetwork({
ssid: 'MyNetwork',
password: 'mypassword',
isHiddenSsid: false,
securityType: NetworkSecurityType.WPA2_PSK
});
connect
Connettiti a una rete Wi-Fi. Su Android, crea una connessione temporanea che per default non instrada il traffico attraverso la rete. Imposta autoRouteTraffic su true per associare il traffico dell'app alla rete connessa (utile per AP locali o ospitati sul dispositivo). Per una connessione persistente su Android, usa addNetwork(). Su iOS, crea una connessione persistente.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.connect({
ssid: 'MyNetwork',
password: 'mypassword',
autoRouteTraffic: true // Android only: route app traffic through this network
});
disconnect
Disconnettiti dalla rete Wi-Fi corrente. Su iOS, si disconnette solo dalle reti aggiunte tramite questo plugin.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.disconnect();
getAvailableNetworks
Ottieni un elenco delle reti Wi-Fi disponibili dall'ultima scansione. Disponibile solo su Android.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-wifi/
- Documentazione: /docs/plugins/wifi/
Continua da Usare @capgo/capacitor-wifi
Se stai usando Usare @capgo/capacitor-wifi per pianificare le operazioni della dashboard e di API, collegalo a @capgo/capacitor-wifi per i dettagli implementativi in @capgo/capacitor-wifi, Per iniziare per i dettagli di implementazione nella guida introduttiva, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, e Chiavi API per i dettagli implementativi in API Keys.