@capgo/capacitor-wifi
Panoramica
Sezione intitolata “Panoramica”Gestisci la connettività WiFi per la tua app Capacitor
Inizia con addNetwork() e gli altri metodi principali elencati qui sotto.
Supporto piattaforme
Sezione intitolata “Supporto piattaforme”| Piattaforma | Supporto | Note |
|---|---|---|
| iOS | Sì | Nativo |
| Android | Sì | Nativo |
| Web | No | Proteggi con Capacitor.getPlatform() |
Funzionalità principali
Sezione intitolata “Funzionalità principali”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.
Pubblico API
Sezione intitolata “API pubblica”| 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, 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. |
disconnect | Disconnettiti dalla rete Wi-Fi corrente. Su iOS, si disconnette solo dalle reti aggiunte tramite questo plugin. |
getAvailableNetworks | Ottieni un elenco delle reti Wi-Fi disponibili dall'ultima scansione. Disponibile solo su Android. |
getIpAddress | Ottieni l'indirizzo IP attuale del dispositivo. Disponibile sia su Android che su iOS. |
getRssi | Ottieni l'indicatore dell'intensità 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 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. |
isEnabled | Controlla 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 forniti tramite l'event listener 'networksScanned'. Nota: potrebbe fallire a causa del throttling di sistema o di problemi hardware. |
checkPermissions | Verifica lo stato attuale dell'autorizzazione per l'accesso alla posizione. L'autorizzazione alla posizione è richiesta per le operazioni Wi-Fi su entrambe le piattaforme. |
requestPermissions | Richiedi le autorizzazioni di posizione all'utente. L'autorizzazione di posizione è obbligatoria 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 | - Rimuove tutti i listener di questo plugin. |
getPluginVersion | Ottieni la versione del plugin nativo. |
Fonte di verità
Sezione intitolata “Fonte di verità”Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-wifi.
Continua da @capgo/capacitor-wifi
Sezione intitolata “Continua da @capgo/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.