Vai al contenuto principale
@capgo/capacitor-wifi Open source Icona plugin WiFi

WiFi Plugin Capacitor

Gestisci la connessione Wi-Fi per il tuo Capacitor app

Installa

bun add @capgo/capacitor-wifi bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-wifi
  • pnpm add @capgo/capacitor-wifi
  • yarn add @capgo/capacitor-wifi

Guida

Come utilizzare la rete WiFi in Capacitor

Testa sul dispositivo

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

Collegamento QR di anteprima del plugin WiFi code

Utilizza @capgo/capacitor-wifi

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

Installa

bun add @capgo/capacitor-wifi
bunx cap sync

Cosa 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, questo si connette alla rete direttamente.
  • connect - Si connette 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() invece. 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 l'elenco 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, NetworkSecurityType } 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 il 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() invece. Su iOS, 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 l'elenco 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 qui: Utilizzo di @capgo/capacitor-wifi

Se stai utilizzando Utilizzando @capgo/capacitor-wifi per pianificare la dashboard e le operazioni di API, connettilo con @capgo/capacitor-wifi per i dettagli di implementazione in @capgo/capacitor-wifi, Avvio rapido per i dettagli di implementazione in Avvio rapido, 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.

FAQ

Domande frequenti sul plugin WiFi

Come posso installare il plugin WiFi in un'app Capacitor?

Esegui "bun add @capgo/capacitor-wifi" (o "npm install @capgo/capacitor-wifi"), quindi esegui "bunx cap sync" per far riconoscere ai progetti iOS e Android il nativo code. Importalo da "@capgo/capacitor-wifi" nella tua app code.

Funziona @capgo/capacitor-wifi con React, Vue e Angular?

Sì. Il pacchetto WiFi è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-wifi?

I plugin Capgo seguono la versione maggiore di Capacitor: utilizzare la versione maggiore del plugin che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

È @capgo/capacitor-wifi gratuito e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-wifi/ e il pacchetto è gratuito per l'installazione da npm. I segnalazioni di bug e le richieste di pull sono benvenute.

Posso aggiornare code che utilizza WiFi senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica la code nativa, quindi richiede una nuova costruzione del store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con gli aggiornamenti live di Capgo.

Condividi le modifiche WiFi senza dover attendere la revisione dell'app

Una volta che il plugin è presente nella tua build di store, Capgo le aggiornamenti in tempo reale inviano i cambiamenti JavaScript, HTML e CSS agli utenti in pochi minuti.

Avvia con Capgo