Vai al contenuto

@capgo/capacitor-wifi

Gestisci la connettività WiFi per la tua app Capacitor

Gestisci la connettività WiFi per la tua app Capacitor

Inizia con addNetwork() e gli altri metodi principali elencati qui sotto.

PiattaformaSupportoNote
iOSSìNativo
AndroidSìNativo
WebNoProteggi con Capacitor.getPlatform()
  • 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 già compilata. Su iOS, si connette direttamente alla rete.
  • connect - Connetti a una rete Wi-Fi. Su Android, questo crea una connessione temporanea che per impostazione predefinita non instrada il traffico attraverso la rete. Imposta autoRouteTraffic su true per vincolare il traffico dell'app alla rete connessa (utile per AP locali/hostati sul dispositivo). Per una connessione persistente su Android, usa addNetwork() invece. Su iOS, questo 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.
MetodoDescrizione
addNetworkMostra 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.
connectConnettiti a una rete Wi-Fi. Su Android, questo crea una connessione temporanea che di default non instrada il traffico attraverso la rete. Imposta autoRouteTraffic a 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, questo crea una connessione persistente.
disconnectDisconnettiti dalla rete Wi-Fi corrente. Su iOS, si disconnette solo dalle reti aggiunte tramite questo plugin.
getAvailableNetworksOttieni un elenco delle reti Wi-Fi disponibili dall'ultima scansione. Disponibile solo su Android.
getIpAddressOttieni l'indirizzo IP attuale del dispositivo. Disponibile sia su Android che su iOS.
getRssiOttieni l'indicatore dell'intensità del segnale ricevuto (RSSI) della rete corrente in dBm. Disponibile solo su Android.
getSsidOttieni il service set identifier (SSID) della rete corrente. Disponibile sia su Android che su iOS.
getWifiInfoOttieni informazioni complete sulla rete WiFi attualmente connessa. Questo metodo fornisce in una sola chiamata informazioni dettagliate sulla rete, tra cui SSID, BSSID, indirizzo IP, frequenza, link speed e potenza del segnale. Su iOS, alcuni campi potrebbero non essere disponibili e saranno undefined.
isEnabledControlla se il Wi-Fi è abilitato sul dispositivo. Disponibile solo su Android.
startScanAvvia la scansione delle reti Wi-Fi. Disponibile solo su Android. I risultati vengono forniti tramite l'event listener 'networksScanned'. Nota: potrebbe fallire a causa del throttling di sistema o di problemi hardware.
checkPermissionsVerifica lo stato attuale dell'autorizzazione per l'accesso alla posizione. L'autorizzazione alla posizione è richiesta per le operazioni Wi-Fi su entrambe le piattaforme.
requestPermissionsRichiedi le autorizzazioni di posizione all'utente. L'autorizzazione di posizione è obbligatoria per le operazioni Wi-Fi su entrambe le piattaforme.
addListenerAggiungi un listener per l'evento 'networksScanned'. Disponibile solo su Android. Questo evento viene emesso quando i risultati della scansione Wi-Fi sono disponibili.
removeAllListeners- Rimuove tutti i listener di questo plugin.
getPluginVersionOttieni la versione del plugin nativo.

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

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