wx.connectWifi(Object object)

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

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

连接 Wi-Fi。若已知 Wi-Fi 信息，可以直接利用该接口连接。仅 Android 与 iOS 11 以上版本支持。

参数

Object object

属性类型默认值必填说明最低版本
SSIDstring是Wi-Fi 设备 SSID
BSSIDstring否Wi-Fi 设备 BSSID
passwordstring是Wi-Fi 设备密码
maunalbooleanfalse否跳转到系统设置页进行连接，仅安卓生效2.12.0
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码错误信息说明
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 后重试

示例代码

  1. wx.connectWifi({
  2.   SSID: '',
  3.   password: '',
  4.   success (res) {
  5.     console.log(res.errMsg)
  6.   }
  7. })