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 bereitstellt

  • addNetwork - Ein Systemdialog anzeigen, um eine WLAN-Netzwerk auf das Gerät 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 - Eine Verbindung zu einem WLAN-Netzwerk herstellen. 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 (nützlich für lokale/gerätegehostete APs) zu binden. Für eine persistente Verbindung auf Android verwenden Sie stattdessen addNetwork(). Auf iOS erstellt dies eine persistente Verbindung.
  • disconnect - Von der aktuellen WLAN-Netzwerkverbindung trennen. Auf iOS trennt dies nur von Netzwerken, die über dieses Plugin hinzugefügt wurden.
  • getAvailableNetworks - Eine Liste der verfügbaren WLAN-Netzwerke aus der letzten Scan erhalten. Nur auf Android verfügbar.

Beispiel zur Verwendung

addNetwork

Ein Systemdialog anzeigen, um eine WLAN-Netzwerk auf das Gerät 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 verbinden. 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 trennen. Auf iOS trennt dies nur von Netzwerken, die über diesen Plugin hinzugefügt wurden.

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

await CapacitorWifi.disconnect();

getAvailableNetworks

Eine 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

Weitermachen 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 Wenn Sie @capgo/capacitor-wifi verwenden für die Implementierungsdetails in @capgo/capacitor-wifi Einstieg für die Implementierungsdetails in Einstieg API Übersicht für die Implementierungsdetails in API Übersicht Einführung für die Implementierungsdetails in Einführung und API Schlüssel for the implementation detail in API Keys.