Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-wifi
Tutorial
von github.com/Cap-go

WiFi

Verwalten Sie die WiFi-Verbindung für Ihre Capacitor-App

Richtlinie

Tutorial zum WiFi

Mit @capgo/capacitor-wifi verwenden

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

Installieren

bun add @capgo/capacitor-wifi
bunx cap sync

Was diese Erweiterung bereitstellt

  • addNetwork - Ein Systemdialog anzeigen, um einem Gerät einen Wi-Fi-Netzwerk hinzuzufügen. Auf Android SDK 30+, öffnet dies die Systemeinstellungen für Wi-Fi mit dem Netzwerk vorausgefüllt. Auf iOS verbindet dies das Gerät direkt mit dem Netzwerk.
  • connect - Zu einem 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 den Datenverkehr der Anwendung 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 - Von dem aktuellen Wi-Fi-Netzwerk trennen. Auf iOS trennt dies nur von Netzwerken, die über diese Erweiterung hinzugefügt wurden.
  • getAvailableNetworks - Eine Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan erhalten. Nur auf Android verfügbar.

Beispiel zur Verwendung

addNetwork

Ein Systemdialog anzeigen, um einem Gerät ein Wi-Fi-Netzwerk hinzuzufügen. Auf Android SDK 30+, öffnet dies die Systemeinstellungen für Wi-Fi mit dem Netzwerk vorausgefüllt. Auf iOS verbindet dies 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

Zu einem 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 den Datenverkehr der Anwendung 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.

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

await CapacitorWifi.connect({
  ssid: 'MyNetwork',
  password: 'mypassword',
  autoRouteTraffic: true // Android only: route app traffic through this network
});

disconnect

Von dem aktuellen Wi-Fi-Netzwerk trennen. Auf iOS trennt dies nur von Netzwerken, die über diese Erweiterung hinzugefügt wurden.

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

await CapacitorWifi.disconnect();

getAvailableNetworks

Erfassen 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 mit Using @capgo/capacitor-wifi

Wenn Sie Using @capgo/capacitor-wifi zur Planung Ihres Dashboards und API-Operationen verwenden, verbinden Sie es mit @capgo/capacitor-wifi für die Implementierungsdetails in @capgo/capacitor-wifi, Einstieg für die Implementierungsdetails in Getting Started, 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.