Übersicht
Abschnitt mit dem Titel “Übersicht”WiFi-Plugin für die Verwaltung der Geräte-WLAN-Konnektivität.
Hauptfunktionen
Abschnitt mit dem Titel “Hauptfunktionen”addNetwork- Zeigt ein Systemdialog an, um ein WLAN-Netzwerk zum Gerät hinzuzufügen. Auf Android SDK 30+, öffnet dies die Systemeinstellungen für WLAN mit dem Netzwerk vorab ausgefüllt. Auf iOS verbindet es sich direkt mit dem Netzwerk.connect- Verbinden Sie sich mit einem Wi-Fi-Netzwerk. Auf Android erstellt dies eine temporäre Verbindung, die standardmäßig nicht den Datenverkehr durch das Netzwerk leitet. Setzen Sie autoRouteTraffic auf true, um die Anwendungsverbindung an das verbundene Netzwerk zu binden (nützlich für lokale/gerätegehostete APs). Für eine persistente Verbindung auf Android verwenden Sie stattdessen addNetwork(). Auf iOS erstellt dies eine persistente Verbindung.disconnect- Trennen Sie sich vom aktuellen Wi-Fi-Netzwerk. Auf iOS werden nur Netzwerke getrennt, die über diesen Plugin hinzugefügt wurden.getAvailableNetworks- Holen Sie sich eine Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan. Nur auf Android verfügbar.
Öffentlich API
Abschnitt mit dem Titel “Öffentlich API”| Methode | Beschreibung |
|---|---|
addNetwork | Zeigen Sie einem Systemdialog ein, um ein Wi-Fi-Netzwerk zum 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 | Verbinden Sie sich mit einem Wi-Fi-Netzwerk. Auf Android erstellt dies eine temporäre Verbindung, die standardmäßig nicht den Datenverkehr durch das Netzwerk leitet. Setzen Sie autoRouteTraffic auf true, um die Anwendungsverbindung an das verbundene Netzwerk zu binden (nützlich für lokale/gerätegehostete APs). Für eine persistente Verbindung auf Android verwenden Sie stattdessen addNetwork(). Auf iOS erstellt dies eine persistente Verbindung. |
disconnect | Trennen Sie sich vom aktuellen Wi-Fi-Netzwerk. Auf iOS werden nur Netzwerke getrennt, die über diesen Plugin hinzugefügt wurden. |
getAvailableNetworks | Holten Sie sich eine Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan. Nur auf Android verfügbar. |
getIpAddress | Holten Sie sich die IP-Adresse des Geräts. Verfügbar auf beiden Android und iOS. |
getRssi | Erhalten Sie den Empfangsstärkeindikator (RSSI) des aktuellen Netzwerks in dBm. Nur auf Android verfügbar. |
getSsid | Erhalten Sie den Dienst-Set-Identifier (SSID) des aktuellen Netzwerks. Verfügbar auf beiden Android und iOS. |
getWifiInfo | Erhalten Sie umfassende Informationen über das derzeit verbundene WLAN-Netzwerk. Diese Methode liefert detaillierte Netzwerkinformationen einschließlich SSID, BSSID, IP-Adresse, Frequenz, Link-Geschwindigkeit und Signalstärke in einem einzigen Aufruf. Auf iOS mögen einige Felder nicht verfügbar sein und werden als undefiniert sein. |
isEnabled | Überprüfen Sie, ob Wi-Fi auf dem Gerät aktiviert ist. Nur auf Android verfügbar. |
startScan | Starten Sie die Suche nach WLAN-Netzwerken. Nur auf Android verfügbar. Die Ergebnisse werden über den ‘networksScanned’- Ereignislistener übermittelt. Hinweis: Es kann aufgrund von Systemdrosselung oder Hardwareproblemen fehlschlagen. |
checkPermissions | Überprüfen Sie den aktuellen Berechtigungsstatus für die Standortzugriffsberechtigung. Die Standortberechtigung ist für WLAN-Operationen auf beiden Plattformen erforderlich. |
requestPermissions | Stellen Sie die Standortberechtigung vom Benutzer an. Die Standortberechtigung ist für WLAN-Operationen auf beiden Plattformen erforderlich. |
addListener | Hinzufügen eines Ereignislisteners für das ‘networksScanned’-Ereignis. Nur auf Android verfügbar. Dieses Ereignis wird ausgelöst, wenn WLAN-Suchergebnisse verfügbar sind. |
removeAllListeners | Entfernen Sie alle Listener für dieses Plugin. |
getPluginVersion | Erhalten Sie die native Pluginversion. |
Wahrheitsquelle
Abschnitt mit dem Titel ‘Wahrheitsquelle’Diese Referenz ist synchronisiert von src/definitions.ts in capacitor-WLAN.