Vai direttamente al contenuto principale
Capgo logo
Indietro ai plugin

Guida

Tutoriale su WiFi

Testare sul dispositivo

Scarica l'app Capgo, poi scansione il codice QR code.

App Store Google Play
Collegamento Wi-Fi di anteprima QR code

Utilizza @capgo/capacitor-wifi

Plugin Wi-Fi per la gestione della connettività Wi-Fi del dispositivo.

Installa

bun add @capgo/capacitor-wifi
bunx cap sync

Cos'è che questo plugin espone

  • addNetwork - Mostra un dialogo del sistema per aggiungere una rete Wi-Fi al dispositivo. Su Android SDK 30+, questo apre le impostazioni di rete Wi-Fi del sistema con la rete precompilata. Su iOS, si connette direttamente alla rete.
  • connect - Collegati a una rete Wi-Fi. Su Android, questo crea una connessione temporanea che non invia traffico per impostazione predefinita. Imposta autoRouteTraffic su true per legare il traffico dell'app alla rete connessa (utile per AP locali/host device). Per una connessione persistente su Android, utilizza addNetwork() al posto di questo. Su iOS, questo crea una connessione persistente.
  • disconnect - Disconnetti dalla rete Wi-Fi corrente. Su iOS, si disconnette solo dalle reti aggiunte tramite questo plugin.
  • getAvailableNetworks - Ottieni una lista delle reti Wi-Fi disponibili dall'ultimo scan. Disponibile solo su Android.

Esempio di utilizzo

addNetwork

Mostra un dialogo del sistema per aggiungere una rete Wi-Fi al dispositivo. Su Android SDK 30+, questo apre le impostazioni di rete Wi-Fi del sistema con la rete precompilata. Su iOS, si connette direttamente alla rete.

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.addNetwork({
  ssid: 'MyNetwork',
  password: 'mypassword',
  isHiddenSsid: false,
  securityType: NetworkSecurityType.WPA2_PSK
});

connect

Connetti a una rete Wi-Fi. Su Android, questo crea una connessione temporanea che non invia traffico per impostazione predefinita. Imposta autoRouteTraffic su true per legare il traffico dell'app alla rete connessa (utile per AP locali/dispositivi). Per una connessione persistente su Android, utilizza addNetwork() invece. Su iOS, questo 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

Disconnetti 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 una lista delle reti Wi-Fi disponibili dall'ultimo scan. 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

Continua da Utilizza @capgo/capacitor-wifi

Se stai utilizzando Utilizza @capgo/capacitor-wifi per pianificare il dashboard e le operazioni di API, connettilo con @capgo/capacitor-wifi per i dettagli di implementazione in @capgo/capacitor-wifi, Iniziare per i dettagli di implementazione in Iniziare, Panoramica di API per i dettagli di implementazione in Panoramica di API Introduzione per i dettagli di implementazione in Introduzione, e Chiavi di API per i dettagli di implementazione in Chiavi di API.