跳过内容

@capgo/capacitor-无线

WiFi插件,用于管理设备WiFi连接

WiFi设备管理插件。

核心功能

核心功能部分
  • addNetwork - 在设备上显示一个系统对话框,添加一个Wi-Fi网络。 在AndroidSDK 30+上,这会打开系统Wi-Fi设置,网络预填充。 在iOS上,这会直接连接到网络。
  • connect - 连接到Wi-Fi网络。 在Android上,这会创建一个临时连接,网络流量不会默认通过该网络。 如果需要将应用程序流量绑定到已连接的网络(适用于本地/设备托管AP),请设置autoRouteTraffic为true。 在Android上,使用addNetwork()方法创建一个持久连接。 在iOS上,这会创建一个持久连接。
  • disconnect - 从当前Wi-Fi网络断开连接。 在iOS上,只断开了通过此插件添加的网络。
  • getAvailableNetworks - 获取上一次扫描后可用的Wi-Fi网络列表。 只在Android上可用。
方法描述
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检查当前位置访问权限状态。位置权限在两种平台上都需要,用于 Wi-Fi 操作。
requestPermissions向用户请求位置权限。位置权限在两种平台上都需要,用于 Wi-Fi 操作。
addListener添加 'networksScanned' 事件监听器。仅在 Android 上可用。该事件在 Wi-Fi 扫描结果可用时触发。
removeAllListeners移除此插件的所有监听器。
getPluginVersion获取本机插件版本。

此参考是从 src/definitions.ts 在 capacitor-wifi.

如果您正在使用 @capgo/capacitor-无线网 与 使用 @capgo/capacitor-wifi 连接 @capgo/capacitor-wifi Capgo 插件目录 Capgo 插件目录 Capacitor 由 Capgo 提供的插件 为 Capacitor 插件的实现细节提供了 Capgo 的支持。 添加或更新插件 添加或更新插件 Ionic 企业版插件替代方案 为Ionic企业插件替代品工作流程。