使用 @capgo/capacitor-wifi
WiFi 插件用于管理设备 WiFi 连接。
安装
bun add @capgo/capacitor-wifi
bunx cap sync
此插件暴露的内容
addNetwork- 在 Android 设备上（SDK 30+），显示一个系统对话框，添加一个 WiFi 网络到设备上。这个对话框会打开系统 WiFi 设置，网络会被预填充。connect- 连接到一个 WiFi 网络。 在 Android 设备上，创建一个临时连接，不会将流量路由到网络中（除非设置 autoRouteTraffic 为 true）。 在 iOS 设备上，创建一个持久连接。disconnect- 从当前 WiFi 网络断开连接。 在 iOS 设备上，只断开从此插件添加的网络。getAvailableNetworks- Android 设备上可获取上一次扫描时可用的 Wi-Fi 网络列表。
示例用途
addNetwork
Show a system dialog to add a Wi-Fi network to the device. On Android SDK 30+, this opens the system Wi-Fi settings with the network pre-filled. On iOS, this connects to the network directly.
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，否则不会将流量路由到该网络。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
Android 设备上可获取上一次扫描时可用的 Wi-Fi 网络列表。
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 规划仪表板和API操作，连接它 @capgo/capacitor无线网 查看@capgo/capacitor-wifi的实现细节 开始使用 查看开始使用的实现细节 API概述 查看API概述的实现细节 介绍 查看介绍的实现细节，并且 API密钥 查看API密钥的实现细节