Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-wifi
Tutorial
@capgo/capacitor-wifi

WiFi

Verwalten Sie die WiFi-Konnektivität für Ihre Capacitor-Anwendung

Richtlinie

Tutorial zur WiFi-Konnektivität

Mit @capgo/capacitor-wifi verwenden

WiFi-Plugin zur Verwaltung der Geräte-WiFi-Konnektivität.

Installieren

bun add @capgo/capacitor-wifi
bunx cap sync

Was diese Erweiterung offenlegt

  • addNetwork - Zeigt ein Systemdialog an, um einem Wi-Fi-Netzwerk auf dem 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 - Verbindet sich mit einem Wi-Fi-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 Datenverkehr der Anwendung an das verbundene Netzwerk zu binden (nützlich für lokale/gerätegehostete APs). Für eine persistente Verbindung auf Android verwende stattdessen addNetwork(). Auf iOS erstellt dies eine persistente Verbindung.
  • disconnect - Trennt sich vom aktuellen Wi-Fi-Netzwerk. Auf iOS trennt dies nur von Netzwerken, die über diese Erweiterung hinzugefügt wurden.
  • getAvailableNetworks - Holt sich eine Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan. Nur auf Android verfügbar.

Beispielhafte Verwendung

addNetwork

Zeigt ein Systemdialog an, um einem Wi-Fi-Netzwerk auf dem 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.

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

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

connect

Verbindet sich mit einem Wi-Fi-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 Datenverkehr der Anwendung an das verbundene Netzwerk zu binden (nützlich für lokale/gerätegehostete APs). Für eine persistente Verbindung auf Android verwende 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

Trennt sich vom aktuellen Wi-Fi-Netzwerk. Auf iOS trennt dies nur von Netzwerken, die über diese Erweiterung hinzugefügt wurden.

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

await CapacitorWifi.disconnect();

getAvailableNetworks

Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan anzeigen. 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 Mit @capgo/capacitor-wifi planen Sie die Dashboard- und API-Operationen, 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.