wx.setWifiList¶
- wx.setWifiList(Object object)¶
基础库 1.6.0 开始支持，低版本需做兼容处理。
设置 wifiList 中 AP 的相关信息。在 onGetWifiList 回调后调用，iOS特有接口。
参数 Object object 属性 类型 默认值 必填 说明 wifiList Array.<Object> 是 提供预设的 Wi-Fi 信息列表 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） object.wifiList 的结构
属性 类型 默认值 必填 说明 SSID string 否 Wi-Fi 的 SSID BSSID string 否 Wi-Fi 的 BSSID password string 否 Wi-Fi 设备密码 错误 错误码 错误信息 说明 0 ok 正常 12000 not init 未先调用 startWifi 接口 12001 system not support 当前系统不支持相关能力 12002 password error Wi-Fi 密码错误 12003 connection timeout 连接超时 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 后重试 注意 该接口只能在 onGetWifiList 回调之后才能调用。 此时客户端会挂起，等待小程序设置 Wi-Fi 信息，请务必尽快调用该接口，若无数据请传入一个空数组。 有可能随着周边 Wi-Fi 列表的刷新，单个流程内收到多次带有存在重复的 Wi-Fi 列表的回调。 示例代码 wx.onGetWifiList(function (res) {
- if (res.wifiList.length) {
- wx.setWifiList({
- wifiList: [{
SSID: res.wifiList[0].SSID, BSSID: res.wifiList[0].BSSID, password: ‘123456’
}]
})
- } else {
- wx.setWifiList({
wifiList: []
})
}
}) wx.getWifiList()