@capgo/capacitor-wifi

Übersicht

Verwalte die WiFi-Verbindung deiner Capacitor App

Starte mit addNetwork() und den anderen unten aufgeführten Core-Methoden.

Plattformunterstützung

Plattform	Support	Notizen
iOS	Ja	Native
Android	Ja	Nativ
Web	Nein	Absichern mit Capacitor.getPlatform()

Kernfunktionen

• 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 Wi-Fi-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 oder auf dem Gerät gehostete APs). Nutze für eine dauerhafte Verbindung auf Android addNetwork(). Auf 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.

Öffentliches API

Methode	Beschreibung
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	Verbindet mit einem WLAN-Netzwerk. 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 Netzwerk zu binden (nützlich für lokale/lokal gehostete APs). Nutze für eine dauerhafte Verbindung auf Android addNetwork(). Auf iOS wird eine persistente Verbindung erstellt.
disconnect	Trennt die Verbindung zum aktuellen WLAN-Netzwerk. Auf iOS werden nur Netzwerke getrennt, die über dieses Plugin hinzugefügt wurden.
getAvailableNetworks	Ruft eine Liste verfügbarer WLAN-Netzwerke aus dem letzten Scan ab. Nur auf Android verfügbar.
getIpAddress	Ruft die aktuelle IP-Adresse des Geräts ab. Verfügbar auf Android und iOS.
getRssi	Ruft den RSSI-Wert (Signalstärke) des aktuellen Netzwerks in dBm ab. Nur auf Android verfügbar.
getSsid	Ruft die Service Set Identifier (SSID) des aktuellen Netzwerks ab. Verfügbar für Android und iOS.
getWifiInfo	Liefert umfassende Informationen über das aktuell verbundene WLAN. Diese Methode bietet detaillierte Netzwerkdaten wie SSID, BSSID, IP-Adresse, Frequenz, Link-Speed und Signalstärke in einem einzigen Call. Auf iOS sind einige Felder eventuell nicht verfügbar und werden undefined.
isEnabled	Prüft, ob WLAN auf dem Gerät aktiviert ist. Nur auf Android verfügbar.
startScan	Startet das Scannen nach Wi-Fi-Netzwerken. Nur unter Android verfügbar. Die Ergebnisse werden über den ‘networksScanned’-Event-Listener geliefert. Hinweis: Kann aufgrund von System-Throttling oder Hardwareproblemen fehlschlagen.
checkPermissions	Prüft den aktuellen Status der Standortberechtigung. Die Standortberechtigung ist für Wi-Fi-Operationen auf beiden Plattformen erforderlich.
requestPermissions	Fordert die Standortberechtigung beim Nutzer an. Die Standortberechtigung ist für Wi-Fi-Operationen auf beiden Plattformen erforderlich.
addListener	Fügt einen Listener für das ‘networksScanned’-Event hinzu. Nur unter Android verfügbar. Dieses Event wird ausgelöst, sobald Wi-Fi-Scan-Ergebnisse verfügbar sind.
removeAllListeners	Entfernt alle Listener für dieses Plugin.
getPluginVersion	Ruft die native Plugin-Version ab.

Source of Truth

Diese Referenz wird synchronisiert von src/definitions.ts in capacitor-wifi.

Weiter mit @capgo/capacitor-wifi

Wenn du es nutzt @capgo/capacitor-wifi Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Mit @capgo/capacitor-wifi für die native Funktion bei der Verwendung von @capgo/capacitor-wifi, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.