Zum Hauptinhalt springen

Anleitung

Tutorial zum WiFi

Auf Gerät testen

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

WLAN-Plugin-Vorschau-QR code

Verwendung von @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 öffnen, um ein WLAN-Netzwerk zum Gerät hinzuzufügen. Auf Android SDK 30+, öffnet sich das System-WLAN-Einstellungs-Menü mit dem Netzwerk vorausgefüllt. Auf iOS verbindet sich das Gerät direkt mit dem Netzwerk.
  • connect - Sich mit einem WLAN-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 den Anwendungsdatenverkehr 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 - Sich vom aktuellen WLAN-Netzwerk trennen. Auf iOS trennt sich das Gerät 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.

Beispielverwendung

addNetwork

Ein Systemdialog öffnen, um ein WLAN-Netzwerk zum Gerät hinzuzufügen. Auf Android SDK 30+, öffnet sich das System-WLAN-Einstellungs-Menü mit dem Netzwerk vorausgefüllt. Auf iOS verbindet sich das Gerät direkt mit dem Netzwerk.

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

await CapacitorWifi.addNetwork({
  ssid: 'MyNetwork',
  password: 'mypassword',
  isHiddenSsid: false,
  securityType: NetworkSecurityType.WPA2_PSK
});

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ä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

Beenden Sie die Verbindung zum aktuellen Wi-Fi-Netzwerk. Auf iOS werden nur Netzwerke getrennt, die über diesen Plugin hinzugefügt wurden.

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

await CapacitorWifi.disconnect();

getAvailableNetworks

Erhalten Sie eine Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan. 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 Sie von Using @capgo/capacitor-wifi

Wenn Sie Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifi verwenden Um das Dashboard und capgo-Operationen zu planen, verbinden Sie es mit @capgo/capacitor-wifi @API/__CAPGO_KEEP_1__-wifi @capgo/capacitor-wifi Für die Implementierungsdetails in @capgo/capacitor-wifi, Anleitung zum Starten Für die Implementierungsdetails in Anleitung zum Starten, API Übersicht Für die Implementierungsdetails in API Übersicht, Einführung Für die Implementierungsdetails in Einführung, und API Schlüssel Für die Implementierungsdetails in API Schlüssel.