Richtlinie
How zu WiFi in Capacitor verwenden
Verwendung von @capgo/capacitor-wifi
WiFi-Plugin für die Verwaltung der Geräte-WLAN-Verbindung
Installieren
bun add @capgo/capacitor-wifi
bunx cap sync
Was diese Erweiterung bereitstellt
addNetwork- Zeigt ein Systemdialog an, um ein WLAN-Netzwerk auf dem Gerät hinzuzufügen. Auf Android SDK 30+ öffnet dies die Systemeinstellungen für WLAN mit dem Netzwerk vorab ausgefüllt. Auf iOS verbindet sich das Gerät direkt mit dem Netzwerk.connect- Verbindet sich mit einem WLAN-Netzwerk. Auf Android erstellt dies eine temporäre Verbindung, die standardmäßig nicht den Datenverkehr durch das Netzwerk leitet. Setze autoRouteTraffic auf true, um den Datenverkehr der App auf das verbundene Netzwerk zu binden (nützlich für lokale/gerätegeführte APs). Für eine persistente Verbindung auf Android verwende stattdessen addNetwork(). Auf iOS erstellt dies eine persistente Verbindung.disconnect- Trennt sich vom aktuellen WLAN-Netzwerk. Auf iOS trennt sich nur von Netzwerken, die über diese Erweiterung hinzugefügt wurden.getAvailableNetworks- Holt sich eine Liste der verfügbaren WLAN-Netzwerke aus der letzten Scan. Nur auf Android verfügbar.
Beispielanwendung
addNetwork
Zeigt ein Systemdialog an, um ein WLAN-Netzwerk auf dem Gerät hinzuzufügen. Auf Android SDK 30+ öffnet dies die Systemeinstellungen für WLAN mit dem Netzwerk vorab ausgefüllt. Auf iOS verbindet sich das Gerät direkt mit dem Netzwerk.
import { CapacitorWifi, NetworkSecurityType } from '@capgo/capacitor-wifi';
await CapacitorWifi.addNetwork({
ssid: 'MyNetwork',
password: 'mypassword',
isHiddenSsid: false,
securityType: NetworkSecurityType.WPA2_PSK
});
connect
Verbindet sich mit einem WLAN-Netzwerk. Auf Android erstellt dies eine temporäre Verbindung, die standardmäßig nicht den Datenverkehr durch das Netzwerk leitet. Setze autoRouteTraffic auf true, um den Datenverkehr der App auf das verbundene Netzwerk zu binden (nützlich für lokale/gerätegeführte APs). Für eine persistente Verbindung auf Android verwende 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
Trennt sich vom aktuellen WLAN-Netzwerk. Auf iOS trennt sich nur von Netzwerken, die über diese Erweiterung hinzugefügt wurden.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.disconnect();
getAvailableNetworks
Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan anzeigen. 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/
Weitermachen von Using @capgo/capacitor-wifi
Wenn Sie Using verwenden Mit @capgo/capacitor-WLAN um das Dashboard und die API-Operationen zu planen, verbinden Sie es mit @capgo/capacitor-WLAN für die Implementierungsdetails in @capgo/capacitor-wifi Getting Started für die Implementierungsdetails in Getting Started API Übersicht für die Implementierungsdetails in API Übersicht Einführung für die Implementierungsdetails in Einführung und API Schlüssel für die Implementierungsdetails in API Schlüssel