@capgo/capacitor-wifi

概览

为您的 Capacitor 应用管理 WiFi 连接

从这里开始 addNetwork() 以及下方列出的其他核心方法。

平台支持

平台	支持	备注
iOS	是	原生
Android	是	原生
Web 端	否	使用 Capacitor.getPlatform() 做保护

核心功能

• 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 支持。

公开 API

方法	描述
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 可用。
getIpAddress	获取设备的当前 IP 地址。Android 和 iOS 均可用。
getRssi	获取当前网络以 dBm 为单位的接收信号强度指示 (RSSI)。仅 Android 可用。
getSsid	获取当前网络的 SSID。Android 和 iOS 均可用。
getWifiInfo	获取当前已连接 WiFi 网络的详细信息。此方法通过单次调用即可提供包括 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-wifi.

从 @capgo/capacitor-wifi 继续

如果你正在使用 @capgo/capacitor-wifi 要规划原生插件工作，请将其与 使用 @capgo/capacitor-wifi 关于使用 @capgo/capacitor-wifi 中的原生能力， Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节， 添加或更新插件 关于“添加或更新插件”中的实现细节，以及 Ionic Enterprise 插件替代方案 关于“Ionic Enterprise 插件替代方案”中的产品工作流。