wx.connectWifi(Object object)

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

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

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

参数

Object object

属性类型默认值必填说明最低版本
SSIDstringWi-Fi 设备 SSID
BSSIDstringWi-Fi 设备 BSSID
passwordstringWi-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. })