用于管理设备 WiFi 连接的 WiFi 插件。
核心功能
标题为“核心功能”的部分addNetwork- 在 Android 设备上（SDK 30+），显示一个系统对话框以添加一个 WiFi 网络到设备。iOS 设备直接连接到网络。connect- 连接到 Wi-Fi 网络。 在 Android 上，这创建了一个临时连接，除非设置了 autoRouteTraffic 为 true，否则不会将流量路由到网络中。 为了在 Android 上创建持久连接，请使用 addNetwork() 代替。 在 iOS 上，这创建了一个持久连接。disconnect- 从当前 Wi-Fi 网络断开连接。 在 iOS 上，只断开了通过此插件添加的网络。getAvailableNetworks- 获取上一次扫描后可用的 Wi-Fi 网络列表。 只在 Android 上可用。
公共 API
公共部分：API| 方法 | 描述 |
|---|---|
addNetwork | 显示一个系统对话框，用于在设备上添加 Wi-Fi 网络。 在 Android SDK 30+ 上，这会打开系统 Wi-Fi 设置，并将网络预填充。 在 iOS 上，这会直接连接到网络。 |
connect | 连接到 Wi-Fi 网络。 在 Android 上，这创建了一个临时连接，除非设置了 autoRouteTraffic 为 true，否则不会将流量路由到网络中。 为了在 Android 上创建持久连接，请使用 addNetwork() 代替。 在 iOS 上，这创建了一个持久连接。 |
disconnect | 断开当前 Wi-Fi 网络的连接。 在 iOS 上，只断开了通过此插件添加的网络。 |
getAvailableNetworks | 获取上一次扫描后可用的 Wi-Fi 网络列表。 只在 Android 上可用。 |
getIpAddress | 获取设备的当前 IP 地址。 在 Android 和 iOS 上都可用。 |
getRssi | 获取当前网络的接收信号强度指标（RSSI）值，单位为 dBm。仅在 Android 上可用。 |
getSsid | 获取当前网络的服务集标识符（SSID）。可在 Android 和 iOS 上使用。 |
getWifiInfo | 获取当前连接的 Wi-Fi 网络的详细信息。该方法提供了SSID、BSSID、IP地址、频率、链路速度和信号强度等信息。iOS 上某些字段可能不可用，会返回 undefined。 |
isEnabled | 检查设备上的 Wi-Fi 是否已启用。仅在 Android 上可用。 |
startScan | 开始扫描 Wi-Fi 网络。仅在 Android 上可用。结果将通过 ‘networksScanned’ 事件监听器传递。注意：可能由于系统限制或硬件问题而失败。 |
checkPermissions | 检查当前位置访问权限的状态。位置权限在两种平台上都需要，用于 Wi-Fi 操作。 |
requestPermissions | 向用户请求位置权限。位置权限在两种平台上都需要，用于 Wi-Fi 操作。 |
addListener | 添加 ‘networksScanned’ 事件的监听器。仅在 Android 上可用。该事件在 Wi-Fi 扫描结果可用时触发。 |
removeAllListeners | 移除所有此插件的监听器。 |
getPluginVersion | 获取本地插件的版本号。 |
真实数据来源
源数据真实性本参考资料是同步自 src/definitions.ts 在 capacitor-无线.