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 dieses Plugin enthält

• addNetwork - Ein Systemdialog anzeigen, um eine Wi-Fi-Netzwerk auf das Gerät hinzuzufügen. Auf Android SDK 30+, öffnet dies die Systemeinstellungen für WLAN mit dem Netzwerk vorab ausgefüllt. Auf iOS verbindet dies direkt mit dem Netzwerk.
• connect - Eine Wi-Fi-Netzwerk verbinden. Auf Android erstellt dies eine temporäre Verbindung, die den Datenverkehr nicht standardmäßig über das Netzwerk leitet. Setzen Sie autoRouteTraffic auf true, um den Anwendungsverkehr an die verbundene Netzwerk (nützlich für lokale/geräte-gesteuerte 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 Wi-Fi-Netzwerk trennen. Auf iOS trennt dies nur von Netzwerken, die über dieses Plugin hinzugefügt wurden.
• getAvailableNetworks - Eine Liste der verfügbaren Wi-Fi-Netzwerke aus der letzten Scan erhalten. Nur auf Android verfügbar.

Beispielanwendung

addNetwork

Ein Systemdialog zum Hinzufügen eines Wi-Fi-Netzwerks zum Gerät anzeigen. Auf Android SDK 30+ öffnet dies die Systemeinstellungen für Wi-Fi mit dem Netzwerk vorbelegt. 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

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

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

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

disconnect

Trennen Sie sich vom aktuellen Wi-Fi-Netzwerk. 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

• GitHub: https://github.com/Cap-go/capacitor-wifi/
• Dokumentation: /docs/plugins/wifi/