Anleitung
WiFi in Capacitor nutzen
Mit @capgo/capacitor-wifi
WiFi-Plugin zur Verwaltung der WLAN-Verbindung des Geräts.
Installieren
bun add @capgo/capacitor-wifi
bunx cap sync
Was dieses Plugin bereitstellt
addNetwork- Zeigt einen Systemdialog an, um ein Wi-Fi-Netzwerk zum Gerät hinzuzufügen. Auf Android SDK 30+ öffnet dies die System-Wi-Fi-Einstellungen mit vorausgefülltem Netzwerk. Auf iOS wird direkt mit dem Netzwerk verbunden.connect- Mit einem WLAN verbinden. Unter Android wird eine temporäre Verbindung erstellt, die den Traffic standardmäßig nicht über das Netzwerk routet. Setze autoRouteTraffic auf true, um den App-Traffic an das verbundene Netzwerk zu binden (nützlich für lokale/vom Gerät gehostete APs). Nutze für eine dauerhafte Verbindung unter Android stattdessen addNetwork(). Unter iOS wird eine dauerhafte Verbindung erstellt.disconnect- Trennt die Verbindung vom aktuellen Wi-Fi-Netzwerk. Auf iOS werden nur Netzwerke getrennt, die über dieses Plugin hinzugefügt wurden.getAvailableNetworks- Ruft eine Liste der verfügbaren Wi-Fi-Netzwerke vom letzten Scan ab. Nur auf Android verfügbar.
Anwendungsbeispiel
addNetwork
Zeigt einen Systemdialog an, um dem Gerät ein WLAN-Netzwerk hinzuzufügen. Auf Android SDK 30+ öffnet sich damit die WLAN-Einstellungen mit bereits eingetragenem Netzwerk. Auf iOS wird direkt eine Verbindung zum Netzwerk hergestellt.
import { CapacitorWifi, NetworkSecurityType } from '@capgo/capacitor-wifi';
await CapacitorWifi.addNetwork({
ssid: 'MyNetwork',
password: 'mypassword',
isHiddenSsid: false,
securityType: NetworkSecurityType.WPA2_PSK
});
connect
Stellt eine Verbindung zu einem WLAN-Netzwerk her. Auf Android wird eine temporäre Verbindung erstellt, die standardmäßig keinen Traffic über das Netzwerk routet. Setze autoRouteTraffic auf true, um den App-Traffic an das verbundene Netzwerk zu binden (nützlich für lokale bzw. vom Gerät gehostete APs). Für eine dauerhafte Verbindung auf Android nutze stattdessen addNetwork(). Auf iOS wird eine dauerhafte Verbindung hergestellt.
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 die Verbindung zum aktuellen WLAN-Netzwerk. Auf iOS werden nur Netzwerke getrennt, die über dieses Plugin hinzugefügt wurden.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.disconnect();
getAvailableNetworks
Ruft eine Liste der verfügbaren WLAN-Netzwerke aus dem letzten Scan ab. 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/
- Doku: /docs/plugins/wifi/
Weiterlesen: Using @capgo/capacitor-wifi
Wenn du es nutzt Mit @capgo/capacitor-wifi um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-wifi für das Implementierungsdetail in @capgo/capacitor-wifi, Erste Schritte für die Implementierungsdetails in Erste Schritte, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung und API Schlüssel für die Implementierungsdetails in den API Keys.