使用@capgo/capacitor-wifi
WiFi插件,用于管理设备WiFi连接。
安装
bun add @capgo/capacitor-wifi
bunx cap sync
此插件暴露的内容
addNetwork- 在设备上显示一个系统对话框,添加一个WiFi网络。 在AndroidSDK 30+上,这会打开系统WiFi设置,网络预填充。 在iOS上,这会直接连接到网络。connect- 连接到WiFi网络。 在Android上,这会创建一个临时连接,网络流量不会默认通过该网络。 如果需要将应用程序流量绑定到已连接的网络(适用于本地/设备托管AP),请设置autoRouteTraffic为true。 在Android上,使用addNetwork()创建一个持久连接。 在iOS上,这会创建一个持久连接。disconnect- 从当前WiFi网络断开连接。 在iOS上,只断开了通过此插件添加的网络。getAvailableNetworks- 获取上一次扫描后可用的WiFi网络列表。 只在Android上可用。
示例使用
addNetwork
- 在设备上显示一个系统对话框,添加一个WiFi网络。 在AndroidSDK 30+上,这会打开系统WiFi设置,网络预填充。 在iOS上,这会直接连接到网络。
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.addNetwork({
ssid: 'MyNetwork',
password: 'mypassword',
isHiddenSsid: false,
securityType: NetworkSecurityType.WPA2_PSK
});
connect
连接到 Wi-Fi 网络。 在 Android 上,这会创建一个临时连接,除非设置了 autoRouteTraffic 为 true,否则不会将流量路由到网络中。 如果要绑定应用程序流量到连接的网络(对于本地/设备托管 AP 有用),请设置 autoRouteTraffic 为 true。 在 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 来规划仪表板和 API 操作,连接它到 @capgo/capacitor-wifi 为 @capgo/capacitor-wifi 的实现细节 开始使用 为 Getting Started 的实现细节 API 介绍 为 API 介绍的实现细节, 和 __CAPGO_KEEP_0__ API 为 __CAPGO_KEEP_0__ API 的实现细节 API Keys for the implementation detail in API Keys.