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
- GitHub: https://github.com/Cap-go/capacitor-wifi/
- Dokumentation: /docs/plugins/wifi/
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.