# qa.connectWifi(Object object)

连接 Wi-Fi。若已知 Wi-Fi 信息，可以直接利用该接口连接。

权限要求粗略设备定位

## 参数

### Object object

| 属性 | 类型 | <div style="width: 50px">默认值</div> | <div style="width: 50px">必填</div> | 说明 |
| --- | --- | --- | --- | --- |
| SSID | string |  | 是 | Wi-Fi 设备 SSID |
| BSSID | string |  | 否 | Wi-Fi 设备 BSSID |
| password | string |  | 是 | Wi-Fi 设备密码 |
| success | function |  | 否 | 接口调用成功的回调函数，此时 Wi-Fi 已经成功连接上 |
| fail | function |  | 否 | 接口调用失败的回调函数 |
| complete | function |  | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |

#### object.success 回调函数

##### 参数

###### Object res

| 属性 | 类型                      | 说明       |
| ---- | ------------------------- | ---------- |
| wifi | [WifiInfo](WifiInfo.html) | Wi-Fi 信息 |

## 错误

| 错误码 | 错误信息             | 说明                   |
| ------ | -------------------- | ---------------------- |
| 0      | ok                   | 正常                   |
| 12002  | password error Wi-Fi | 密码错误               |
| 12003  | connection timeout   | 连接超时               |
| 12004  | duplicate request    | 重复连接 Wi-Fi         |
| 12005  | wifi not turned on   | 未打开 Wi-Fi 开关      |
| 12006  | gps not turned on    | 未打开 GPS 定位开关    |
| 12007  | user denied          | 用户拒绝授权链接 Wi-Fi |
| 12008  | invalid SSID         | 无效 SSID              |

## 示例代码

```js
qa.connectWifi({
  SSID: '',
  password: '',
  success(res) {
    console.log(res.errMsg)
  }
})
```
