Richtlinie
Tutorial zur WiFi-Konnektivität
Mit @capgo/capacitor-wifi verwenden
WiFi-Plugin zur Verwaltung der Geräte-WiFi-Konnektivität.
Installieren
bun add @capgo/capacitor-wifi
bunx cap sync
Was diese Erweiterung offenlegt
addNetwork- Zeigt ein Systemdialog an, um einem Wi-Fi-Netzwerk auf dem Gerät hinzuzufügen. Auf Android SDK 30+, öffnet dies die Systemeinstellungen für Wi-Fi mit dem Netzwerk vorab ausgefüllt. Auf iOS verbindet dies direkt mit dem Netzwerk.connect- Verbindet sich mit einem Wi-Fi-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 Anwendung an das verbundene Netzwerk zu binden (nützlich für lokale/gerätegehostete APs). Für eine persistente Verbindung auf Android verwende stattdessen addNetwork(). Auf iOS erstellt dies eine persistente Verbindung.disconnect- Trennt sich vom aktuellen Wi-Fi-Netzwerk. Auf iOS trennt dies nur von Netzwerken, die über diese Erweiterung hinzugefügt wurden.getAvailableNetworks- Holt sich eine Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan. Nur auf Android verfügbar.
Beispielhafte Verwendung
addNetwork
Zeigt ein Systemdialog an, um einem Wi-Fi-Netzwerk auf dem Gerät hinzuzufügen. Auf Android SDK 30+, öffnet dies die Systemeinstellungen für Wi-Fi mit dem Netzwerk vorab ausgefü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
Verbindet sich mit einem Wi-Fi-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 Anwendung an das verbundene Netzwerk zu binden (nützlich für lokale/gerätegehostete 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 Wi-Fi-Netzwerk. Auf iOS trennt dies 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 Mit @capgo/capacitor-wifi planen Sie die Dashboard- und API-Operationen, verbinden Sie es mit @capgo/capacitor-wifi für die Implementierungsdetails in @capgo/capacitor-wifi, Einstieg 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.