@capgo/capacitor-wifi

概览

用于管理设备 WiFi 连接的 WiFi 插件。

核心功能

• addNetwork - 在 Android SDK 30+ 上，显示一个系统对话框以在设备上添加一个 WiFi 网络。这个对话框会在 Android 设备上打开系统 WiFi 设置，并且网络会被预先填充。 在 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	获取当前网络的接收信号强度指标（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	检查当前位置访问权限的状态。位置权限在 Android 和 iOS 平台上都需要，用于 Wi-Fi 操作。
requestPermissions	向用户请求位置访问权限。位置权限在 Android 和 iOS 平台上都需要，用于 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 插件目录, Capacitor 插件由 Capgo 提供 了解 Capacitor 插件由 Capgo 提供的实现细节 添加或更新插件 了解添加或更新插件的实现细节 Ionic 企业插件替代品 了解 Ionic 企业插件替代品的产品工作流程