Zum Hauptinhalt springen

Richtlinie

Tutorial zum WiFi

Auf Gerät testen

Laden Sie die Capgo-App herunter, dann scannen Sie das QR-code-Code.

WLAN-Plugin-Vorschau-QR code

Mit @capgo/capacitor-wlan

WLAN-Plugin für die Verwaltung der Geräte-WLAN-Verbindung.

Installieren

bun add @capgo/capacitor-wifi
bunx cap sync

Was dieses Plugin enthüllt

  • addNetwork - Zeigt ein Systemdialog an, um einem Gerät eine WLAN-Netzwerk hinzuzufügen. Auf Android SDK 30+, öffnet dies die Systemeinstellungen für WLAN mit dem Netzwerk vorausgefüllt. Auf iOS verbindet dies direkt mit dem Netzwerk.
  • connect - Verbindet sich mit einem WLAN-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 Anwendungsverkehr 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 - Trennt sich vom aktuellen WLAN-Netzwerk ab. Auf iOS trennt dies nur von Netzwerken, die über dieses Plugin hinzugefügt wurden.
  • getAvailableNetworks - Liefert eine Liste der verfügbaren WLAN-Netzwerke aus der letzten Scan. Nur auf Android verfügbar.

Beispiel für die Verwendung

addNetwork

Zeigt ein Systemdialog an, um einem Gerät eine WLAN-Netzwerk hinzuzufügen. Auf Android SDK 30+, öffnet dies die Systemeinstellungen für WLAN mit dem Netzwerk vorausgefü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

Zum Wi-Fi-Netzwerk anmelden. 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ätegeführte APs). Für eine persistente Verbindung auf Android verwenden Sie 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

Vom aktuellen Wi-Fi-Netzwerk abmelden. Auf iOS werden nur Netzwerke getrennt, die über diesen Plugin hinzugefügt wurden.

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.disconnect();

getAvailableNetworks

Ein Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan erhalten. 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

Fortsetzen von Using @capgo/capacitor-wifi

Wenn Sie Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifi verwenden Using @capgo/capacitor-wifi @API/__CAPGO_KEEP_1__-wifi Using @capgo/capacitor-wifi zur Implementierungsdetail in @capgo/capacitor-wifi, Anleitung zum Starten zur Implementierungsdetail in Anleitung zum Starten, API Übersicht zur Implementierungsdetail in API Übersicht, Einführung zur Implementierungsdetail in Einführung, und API Schlüssel zur Implementierungsdetail in API Schlüssel.