__CAPGO_KEEP_0__ home
Torna ai plugin
@capgo/capacitor-wifi
Tutorial
di github.com/Cap-go

WiFi

Gestisci la connessione WiFi per la tua app Capacitor

Guida

Tutoriale su WiFi

Utilizzo di @capgo/capacitor-wifi

Plugin WiFi per la gestione della connettività WiFi del dispositivo.

Installa

bun add @capgo/capacitor-wifi
bunx cap sync

Cos'è 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 alla rete direttamente.
  • 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/dispositivi). Per una connessione persistente su Android, utilizza addNetwork() invece. Su iOS, si 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 alla rete direttamente.

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

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

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/dispositivi). Per una connessione persistente su Android, utilizza addNetwork() invece. Su iOS, si 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

Ottenere una lista 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

Continua da qui: Utilizzo di @capgo/capacitor-wifi

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