更新记录

1.0.6（2023-11-13）

• 统一错误码格式
• 修复部分真机未链接wifi可能卡死的bug

1.0.5（2023-10-26）

兼容HBuilder 3.9x 版本

1.0.4（2023-07-26）

• 修复 打开系统wifi开关，但是尚未连接到某一无线网络的情况下，可能卡死的bug

平台兼容性

使用说明

Wi-Fi功能模块

App-iOS平台注意事项

• iOS平台App获取Wi-Fi信息需要开启“Access WiFi information”能力
  登录苹果开发者网站，在“Certificates, Identifiers & Profiles”页面选择“Identifiers”中选择对应的App ID，确保开启“Access WiFi information”，保存后重新生成profile文件
• iOS13及以上系统，获取当前连接的Wi-Fi信息需要先获取系统定位权限，因此在iOS13及以上系统使用此接口时，会触发定位权限申请的弹窗

App-Android平台注意事项

• 如果是自定义基座，需要具备下面的权限

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

uni.startWifi(OBJECT)

初始化Wi-Fi模块。

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#startwifi

uni.stopWifi(OBJECT)

关闭 Wi-Fi 模块。

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#stopwifi

uni.getConnectedWifi(OBJECT)

获取已连接的 Wi-Fi 信息

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#getconnectedwifi

uni.getWifiList(OBJECT)

请求获取 Wi-Fi 列表。wifiList 数据会在 onGetWifiList 注册的回调中返回。

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#getWifiList

平台差异说明

uni.onGetWifiList(CALLBACK)

监听获取到 Wi-Fi 列表数据事件。

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#onGetWifiList

平台差异说明

uni.offGetWifiList(CALLBACK)

移除获取到 Wi-Fi 列表数据事件的监听函数。

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#offGetWifiList

平台差异说明

uni.connectWifi(OBJECT)

连接 Wi-Fi。若已知 Wi-Fi 信息，可以直接利用该接口连接。

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#connectWifi

平台差异说明

uni.onWifiConnected(CALLBACK)

监听连接上 Wi-Fi 的事件。

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#onWifiConnected

平台差异说明

uni.offWifiConnected(CALLBACK)

移除连接上 Wi-Fi 的事件的监听函数。

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#offWifiConnected

平台差异说明

uni.onWifiConnectedWithPartialInfo(CALLBACK)

监听连接上 Wi-Fi 的事件。

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#onWifiConnectedWithPartialInfo

平台差异说明

uni.offWifiConnectedWithPartialInfo(CALLBACK)

移除连接上 Wi-Fi 的事件的监听函数。

使用文档：https://uniapp.dcloud.net.cn/api/system/wifi.html#offWifiConnectedWithPartialInfo

平台差异说明