Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-wifi
Anleitung
@capgo/capacitor-wifi

WLAN

Verwalten Sie die WLAN-Verbindung für Ihre Capacitor-Anwendung

Zum NPM

Anleitung

Tutorial zum WiFi

Download the Capgo app, then scan the QR code.

WLAN-Plugin-Vorschau-QR code

Verwendung von @capgo/capacitor-wlan

WLAN-Plugin zur Verwaltung der Geräte-WLAN-Verbindung.

Installieren

bun add @capgo/capacitor-wifi
bunx cap sync

Wie dieses Plugin ausfällt

  • addNetwork - Ein Systemdialog anzeigen, um ein WLAN-Netzwerk zum Gerät hinzuzufügen. Auf Android SDK 30+, öffnet dies die Systemeinstellungen für WLAN mit dem Netzwerk vorausgefüllt. Auf iOS verbindet dies direkt mit dem Netzwerk.
  • connect - Verbinden Sie sich mit einem WLAN-Netzwerk. Auf Android erstellt dies eine temporäre Verbindung, die standardmäßig nicht den Datenverkehr durch das Netzwerk leitet. Setzen Sie autoRouteTraffic auf true, um die Anwendungstrafik an das verbundene Netzwerk zu binden (nützlich für lokale/gerätegehostete APs). Für eine persistente Verbindung auf Android verwenden Sie stattdessen addNetwork(). Auf iOS erstellt dies eine persistente Verbindung.
  • disconnect - Beenden Sie die Verbindung zum aktuellen WLAN-Netzwerk. Auf iOS beendet dies nur die Verbindung zu Netzwerken, die über dieses Plugin hinzugefügt wurden.
  • getAvailableNetworks - Eine Liste der verfügbaren WLAN-Netzwerke aus der letzten Scan erhalten. Nur auf Android verfügbar.

Beispielverwendung

addNetwork

Ein Systemdialog anzeigen, um ein WLAN-Netzwerk zum Gerät hinzuzufügen. Auf Android SDK 30+, öffnet dies die Systemeinstellungen für WLAN mit dem Netzwerk vorausgefüllt. Auf iOS verbindet dies direkt mit dem Netzwerk.

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

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

connect

Zum Anschluss an ein Wi-Fi-Netzwerk verbinden. Auf Android erstellt dies eine temporäre Verbindung, die standardmäßig nicht den Datenverkehr durch das Netzwerk leitet. Setzen Sie autoRouteTraffic auf true, um die Anwendungsverbindung an das verbundene Netzwerk zu binden (nützlich für lokale/gerätegesteuerte APs). Für eine persistente Verbindung auf Android verwenden Sie stattdessen addNetwork(). Auf iOS erstellt dies eine persistente Verbindung.

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

await CapacitorWifi.connect({
  ssid: 'MyNetwork',
  password: 'mypassword',
  autoRouteTraffic: true // Android only: route app traffic through this network
});

disconnect

Vom aktuellen Wi-Fi-Netzwerk trennen. Auf iOS trennt sich nur von Netzwerken, die über diesen Plugin hinzugefügt wurden.

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

await CapacitorWifi.disconnect();

getAvailableNetworks

Ein Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan erhalten. Nur auf Android verfügbar.

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

const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
  console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});

Vollständige Referenz

Fortsetzen von Using @capgo/capacitor-wifi

Wenn Sie Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifi verwenden Using @capgo/capacitor-wifi zum Planen von Dashboard und capgo-Operationen, verbinden Sie es mit @API/__CAPGO_KEEP_1__-wifi @capgo/capacitor-wifi zur Implementierungsdetail in @capgo/capacitor-wifi, Anleitung zum Starten zur Implementierungsdetail in Anleitung zum Starten, API Übersicht zur Implementierungsdetail in API Übersicht, Einführung zur Implementierungsdetail in Einführung, und API Schlüssel zur Implementierungsdetail in API Schlüssel.