wx.setWifiList(Object object)

基础库 1.6.0 开始支持,低版本需做兼容处理

本接口从基础库版本 2.9.1 起支持在小程序插件中使用

设置 wifiList 中 AP 的相关信息。在 onGetWifiList 回调后调用,iOS特有接口

参数

Object object

属性类型默认值必填说明
wifiListArray.<Object>提供预设的 Wi-Fi 信息列表
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.wifiList 的结构

属性类型默认值必填说明
SSIDstringWi-Fi 的 SSID
BSSIDstringWi-Fi 的 BSSID
passwordstringWi-Fi 设备密码

错误

错误码错误信息说明
0ok正常
12000not init未先调用 startWifi 接口
12001system not support当前系统不支持相关能力
12002password error Wi-Fi密码错误
12003connection timeout连接超时
12004duplicate request重复连接 Wi-Fi
12005wifi not turned onAndroid 特有,未打开 Wi-Fi 开关
12006gps not turned onAndroid 特有,未打开 GPS 定位开关
12007user denied用户拒绝授权链接 Wi-Fi
12008invalid SSID无效 SSID
12009system config err系统运营商配置拒绝连接 Wi-Fi
12010system internal error系统其他错误,需要在 errmsg 打印具体的错误原因
12011weapp in background应用在后台无法配置 Wi-Fi
12013wifi config may be expired系统保存的 Wi-Fi 配置过期,建议忘记 Wi-Fi 后重试

注意

  • 该接口只能在 onGetWifiList 回调之后才能调用。
  • 此时客户端会挂起,等待小程序设置 Wi-Fi 信息,请务必尽快调用该接口,若无数据请传入一个空数组。
  • 有可能随着周边 Wi-Fi 列表的刷新,单个流程内收到多次带有存在重复的 Wi-Fi 列表的回调。

示例代码

  1. wx.onGetWifiList(function(res) {
  2. if (res.wifiList.length) {
  3. wx.setWifiList({
  4. wifiList: [{
  5. SSID: res.wifiList[0].SSID,
  6. BSSID: res.wifiList[0].BSSID,
  7. password: '123456'
  8. }]
  9. })
  10. } else {
  11. wx.setWifiList({
  12. wifiList: []
  13. })
  14. }
  15. })
  16. wx.getWifiList()