Anleitung
WiFi in Capacitor nutzen
Auf dem Gerät testen
Lade die Capgo App herunter und scanne den QR code.
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 WLAN-Netzwerk zum Gerät hinzuzufügen. Auf Android SDK 30+ öffnet dies die WLAN-Einstellungen mit vorausgefülltem Netzwerk. Auf iOS erfolgt die direkte Verbindung zum Netzwerk.connect- Mit einem WLAN-Netzwerk verbinden. 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/lokal gehostete APs). Für eine dauerhafte Verbindung auf Android nutze stattdessen addNetwork(). Auf iOS wird eine dauerhafte Verbindung erstellt.disconnect- Von der aktuellen WLAN-Verbindung trennen. Auf iOS werden nur Netzwerke getrennt, die über dieses Plugin hinzugefügt wurden.getAvailableNetworks- Liste der verfügbaren WLAN-Netzwerke aus dem letzten Scan abrufen. Nur auf Android verfügbar.
Anwendungsbeispiel
addNetwork
Systemdialog zum Hinzufügen eines WLAN-Netzwerks anzeigen. Auf Android SDK 30+ öffnet dies die WLAN-Einstellungen mit vorausgefülltem Netzwerk. Auf iOS erfolgt die direkte Verbindung zum Netzwerk.
import { CapacitorWifi, NetworkSecurityType } from '@capgo/capacitor-wifi';
await CapacitorWifi.addNetwork({
ssid: 'MyNetwork',
password: 'mypassword',
isHiddenSsid: false,
securityType: NetworkSecurityType.WPA2_PSK
});
connect
Mit einem WLAN-Netzwerk verbinden. Auf Android wird eine temporäre Verbindung erstellt, die standardmäßig keinen Traffic routet. Setze autoRouteTraffic auf true, um den App-Traffic an das verbundene Netzwerk zu binden (nützlich für lokale/lokal gehostete APs). Für eine dauerhafte Verbindung auf Android nutze stattdessen addNetwork(). Auf iOS wird eine dauerhafte Verbindung erstellt.
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 WLAN-Netzwerk trennen. Auf iOS werden nur Netzwerke getrennt, die über dieses Plugin hinzugefügt wurden.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.disconnect();
getAvailableNetworks
Liste der verfügbaren WLAN-Netzwerke aus dem letzten Scan abrufen. 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/
- Docs: /docs/plugins/wifi/
Weiterlesen unter Verwendung von @capgo/capacitor-wifi
Wenn du es nutzt Verwendung von @capgo/capacitor-wifi um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-wifi für die Implementierungsdetails 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.