onWifiConnected
该 API 使用方法为 wx.onWifiConnected(function listener)
说明：
支持度：
Android：支持。
iOS：支持。
功能说明：监听连接上 Wi-Fi 的事件。
参数及说明：function listener
连接上 Wi-Fi 的事件的监听函数参数：Object res。
属性 | 类型 | 说明 |
wifi | Wi-Fi 信息 |
onWifiConnected
该 API 使用方法为 wx.onWifiConnected(function listener)
说明：
支持度：
Android：支持。
iOS：支持。
功能说明：监听连接上 Wi-Fi 的事件。
参数及说明：function listener。
连接上 Wi-Fi 的事件的监听函数参数：Object res。
属性 | 类型 | 说明 |
wifi | Wi-Fi 信息 |
stopWifi
该 API 使用方法为 wx.stopWifi(Object object)
功能说明：关闭 Wi-Fi 模块。
参数及说明：Object object。
属性 | 类型 | 默认值 | 必填 | 说明 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
错误码
错误码 | 错误信息 | 说明 |
0 | ok | 正常 |
12000 | not init | 未先调用 startWifi 接口 |
12001 | system not support | 当前系统不支持相关能力 |
12002 | password error Wi-Fi | 密码错误 |
12003 | connection timeout | 连接超时, 仅 Android 支持 |
12004 | duplicate request | 重复连接 Wi-Fi |
12005 | wifi not turned on | Android 特有，未打开 Wi-Fi 开关 |
12006 | gps not turned on | Android 特有，未打开 GPS 定位开关 |
12007 | user denied | 用户拒绝授权链接 Wi-Fi |
12008 | invalid SSID | 无效 SSID |
12009 | system config err | 系统运营商配置拒绝连接 Wi-Fi |
12010 | system internal error | 系统其他错误，需要在 errmsg 打印具体的错误原因 |
12011 | weapp in background | 应用在后台无法配置 Wi-Fi |
12013 | wifi config may be expired | 系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试，仅 Android 支持 |
12014 | invalid WEP / WPA password | iOS 特有，无效的 WEP / WPA 密码 |
示例代码
wx.stopWifi({success (res) {console.log(res.errMsg)}})
startWifi
该 API 使用方法为 wx.startWifi(Object object)
功能说明：初始化 Wi-Fi 模块。
参数及说明：Object object。
属性 | 类型 | 默认值 | 必填 | 说明 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
错误码
错误码 | 错误信息 | 说明 |
0 | ok | 正常 |
12000 | not init | 未先调用 startWifi 接口 |
12001 | system not support | 当前系统不支持相关能力 |
12002 | password error Wi-Fi | 密码错误 |
12003 | connection timeout | 连接超时, 仅 Android 支持 |
12004 | duplicate request | 重复连接 Wi-Fi |
12005 | wifi not turned on | Android 特有，未打开 Wi-Fi 开关 |
12006 | gps not turned on | Android 特有，未打开 GPS 定位开关 |
12007 | user denied | 用户拒绝授权链接 Wi-Fi |
12008 | invalid SSID | 无效 SSID |
12009 | system config err | 系统运营商配置拒绝连接 Wi-Fi |
12010 | system internal error | 系统其他错误，需要在 errmsg 打印具体的错误原因 |
12011 | weapp in background | 应用在后台无法配置 Wi-Fi |
12013 | wifi config may be expired | 系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试，仅 Android 支持 |
12014 | invalid WEP / WPA password | iOS 特有，无效的 WEP / WPA 密码 |
示例代码
wx.startWifi({success (res) {console.log(res.errMsg)}})
onGetWifiList
该 API 使用方法为 wx.onGetWifiList(function listener)
功能说明：监听获取到 Wi-Fi 列表数据事件。
参数及说明：Object res 参数，function listener，获取到 Wi-Fi 列表数据事件的监听函数。
属性 | 类型 | 说明 |
wifiList | Array.<WifiInfo> | Wi-Fi 列表数据 |
offGetWifiList
该 API 使用方法为 wx.offGetWifiList(function listener)
功能说明：移除获取到 Wi-Fi 列表数据事件的监听函数。
参数及说明：function listener，onGetWifiList 传入的监听函数。不传此参数则移除所有监听函数。
getConnectedWifi
该 API 使用方法为 wx.getConnectedWifi(Object object)
功能说明：获取已连接中的 Wi-Fi 信息。
参数及说明：Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
partialInfo | boolean | false | 否 | 是否需要返回部分 Wi-Fi 信息 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
object.success 回调函数参数：Object res
属性 | 类型 | 说明 |
wifi | Wi-Fi 信息 |
错误码
错误码 | 错误信息 | 说明 |
0 | ok | 正常 |
12000 | not init | 未先调用 startWifi 接口 |
12001 | system not support | 当前系统不支持相关能力 |
12002 | password error Wi-Fi | 密码错误 |
12003 | connection timeout | 连接超时, 仅 Android 支持 |
12004 | duplicate request | 重复连接 Wi-Fi |
12005 | wifi not turned on | Android 特有，未打开 Wi-Fi 开关 |
12006 | gps not turned on | Android 特有，未打开 GPS 定位开关 |
12007 | user denied | 用户拒绝授权链接 Wi-Fi |
12008 | invalid SSID | 无效 SSID |
12009 | system config err | 系统运营商配置拒绝连接 Wi-Fi |
12010 | system internal error | 系统其他错误，需要在 errmsg 打印具体的错误原因 |
12011 | weapp in background | 应用在后台无法配置 Wi-Fi |
12013 | wifi config may be expired | 系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试，仅 Android 支持 |
12014 | invalid WEP / WPA password | iOS 特有，无效的 WEP / WPA 密码 |
WifiInfo
功能说明：Wifi 信息。
注意：
Android wx.connectWifi / wx.getConnectedWifi 若设置了 partialInfo:true，或者调用了 wx.onWifiConnectedWithPartialInfo 事件。将会返回只包含 SSID 属性的 WifiInfo 对象。
iOS wx.getConnectedWifi 若设置了 partialInfo:true，将会返回只包含 SSID、BSSID 属性的 WifiInfo 对象，且需要用户开启宿主客户端定位权限才能正确返回结果。
在某些情况下，可能 Wi-Fi 已经连接成功，但会因为获取不到完整的 WifiInfo 对象报错。具体错误信息为
errCode:12010, errMsg: can't gain current wifi 或 no wifi is connected。如果开发者不需要完整的 WifiInfo 对象，则可以通过采取上述策略解决报错问题。属性
string SSID：Wi-Fi 的 SSID。
string BSSID：Wi-Fi 的 BSSID。
boolean secure：Wi-Fi 是否安全。
number signalStrength：Wi-Fi 信号强度，Android 取值 0 ～ 100 ，iOS 取值 0 ～ 1，值越大强度越大。
number frequency：Wi-Fi 频段单位 MHz。
是
否
本页内容是否解决了您的问题？