跳过内容

@capgo/capacitor-wifi

设备WiFi连接管理插件

概述

概述

设备WiFi连接管理插件

  • addNetwork - Show a system dialog to add a Wi-Fi network to the device. On Android SDK 30+, this opens the system Wi-Fi settings with the network pre-filled. On iOS, this connects to the network directly.
  • connect - 从当前WiFi网络断开连接。iOS上只断开通过此插件添加的网络。
  • disconnect 设备WiFi连接管理插件
  • getAvailableNetworks - 从上一次扫描中获取可用的Wi-Fi网络列表。仅在Android上可用。
MethodDescription
addNetwork在Android SDK 30+上显示系统对话框,添加Wi-Fi网络到设备。iOS上直接连接网络。
connect连接Wi-Fi网络。Android上创建临时连接,除非设置autoRouteTraffic为true,否则不会将流量绑定到网络。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.tscapacitor-无线网络.