使用 @capgo/capacitor-wifi
用于管理设备 WiFi 连接的 WiFi 插件。
安装
bun add @capgo/capacitor-wifi
bunx cap sync
插件暴露的内容
addNetwork- 显示系统对话框以向设备添加 Wi-Fi 网络。在 Android SDK 30+ 上，这会打开已预填网络信息的系统 Wi-Fi 设置。在 iOS 上，这会直接连接到该网络。connect- 连接到 Wi-Fi 网络。在 Android 上，这会创建一个默认不通过该网络路由流量的临时连接。将 autoRouteTraffic 设置为 true 可将应用流量绑定到已连接的网络（适用于本地/设备托管的 AP）。若需在 Android 上建立持久连接，请改用 addNetwork()。在 iOS 上，这会创建一个持久连接。disconnect- 断开当前 Wi-Fi 网络连接。在 iOS 上，仅断开通过此插件添加的网络。getAvailableNetworks- 获取上次扫描时可用的 Wi-Fi 网络列表。仅 Android 端可用。
用法示例
addNetwork
显示系统对话框以向设备添加 Wi-Fi 网络。在 Android SDK 30+ 上，这会打开预填好网络信息的系统 Wi-Fi 设置。在 iOS 上，这会直接连接到该网络。
import { CapacitorWifi, NetworkSecurityType } from '@capgo/capacitor-wifi';
await CapacitorWifi.addNetwork({
ssid: 'MyNetwork',
password: 'mypassword',
isHiddenSsid: false,
securityType: NetworkSecurityType.WPA2_PSK
});
connect
连接到 Wi-Fi 网络。在 Android 上，这会创建一个默认不通过该网络路由流量的临时连接。将 autoRouteTraffic 设置为 true 可将应用流量绑定到已连接的网络（适用于本地/设备托管的 AP）。若需在 Android 上建立持久连接，请改用 addNetwork()。在 iOS 上，这会创建一个持久连接。
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.connect({
ssid: 'MyNetwork',
password: 'mypassword',
autoRouteTraffic: true // Android only: route app traffic through this network
});
disconnect
断开当前 Wi-Fi 网络连接。在 iOS 上，仅断开通过此插件添加的网络。
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.disconnect();
getAvailableNetworks
获取上次扫描时可用的 Wi-Fi 网络列表。仅 Android 端可用。
import { CapacitorWifi } from '@capgo/capacitor-wifi';
const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});
完整参考
- GitHub: https://github.com/Cap-go/capacitor-wifi/
- 文档：/docs/plugins/wifi/
继续探索 @capgo/capacitor-wifi
如果你正在使用 使用 @capgo/capacitor-wifi 要规划 dashboard 和 API 操作，请将其连接到 @capgo/capacitor-wifi 有关 @capgo/capacitor-wifi 的实现细节， 快速入门 有关“入门指南”中的实现细节， API 概览 关于 API Overview 中的实现细节， 简介 关于简介中的实现细节，以及 API 密钥 关于 API Keys 中的实现细节。