@capgo/capacitor-wifi

Panoramica

Gestisci la connettività WiFi della tua app Capacitor

Inizia con addNetwork() e gli altri metodi core elencati di seguito.

Piattaforme supportate

Piattaforma	Supporto	Note
iOS	Sì	Nativo
Android	Sì	Nativo
Web	No	Proteggi con Capacitor.getPlatform()

Funzionalità principali

• addNetwork - Mostra un dialogo di sistema per aggiungere una rete Wi-Fi al dispositivo. Su Android SDK 30+, si aprono le impostazioni Wi-Fi con la rete precompilata. Su iOS, la connessione avviene direttamente.
• 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/device-hosted). Per una connessione persistente su Android, usa addNetwork(). Su iOS, crea una connessione persistente.
• disconnect - Disconnettiti dalla rete Wi-Fi corrente. Su iOS, la disconnessione avviene solo per le reti aggiunte tramite questo plugin.
• getAvailableNetworks - Ottieni l'elenco delle reti Wi-Fi disponibili dall'ultimo scan. Disponibile solo su Android.

Pubblico API

Metodo	Descrizione
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.
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 o ospitati sul 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'ultimo scan. Disponibile solo su Android.
getIpAddress	Ottieni l'indirizzo IP corrente del dispositivo. Disponibile sia su Android che su iOS.
getRssi	Ottieni l'indicatore di potenza del segnale ricevuto (RSSI) della rete corrente in dBm. Disponibile solo su Android.
getSsid	Ottieni il service set identifier (SSID) della rete corrente. Disponibile sia su Android che su iOS.
getWifiInfo	Ottieni informazioni complete sulla rete WiFi attualmente connessa. Questo metodo fornisce dettagli sulla rete tra cui SSID, BSSID, indirizzo IP, frequenza, link speed e potenza del segnale in una singola chiamata. Su iOS, alcuni campi potrebbero non essere disponibili e risulteranno undefined.
isEnabled	Verifica se il Wi-Fi è abilitato sul dispositivo. Disponibile solo su Android.
startScan	Avvia la scansione delle reti Wi-Fi. Disponibile solo su Android. I risultati vengono inviati tramite l'event listener ‘networksScanned’. Nota: potrebbe fallire per throttling di sistema o problemi hardware.
checkPermissions	Verifica lo stato attuale dei permessi per la posizione. L'accesso alla posizione è richiesto per le operazioni Wi-Fi su entrambe le piattaforme.
requestPermissions	Richiedi l'autorizzazione alla posizione all'utente. Il permesso di localizzazione è necessario per le operazioni Wi-Fi su entrambe le piattaforme.
addListener	Aggiungi un listener per l'evento ‘networksScanned’. Disponibile solo su Android. Questo evento viene emesso quando i risultati della scansione Wi-Fi sono disponibili.
removeAllListeners	Rimuovi tutti i listener di questo plugin.
getPluginVersion	Ottieni la versione del plugin nativo.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts le capacitor-wifi.

Continua da @capgo/capacitor-wifi

Se stai usando @capgo/capacitor-wifi per pianificare il lavoro sui plugin nativi, collegalo a Utilizzo di @capgo/capacitor-wifi per la funzionalità nativa in Utilizzo di @capgo/capacitor-wifi, Directory dei plugin Capgo per il workflow del prodotto nella Directory dei plugin Capgo, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins by Capgo, Aggiungere o aggiornare i plugin per i dettagli di implementazione in Aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin di Ionic Enterprise.