Taro.setWifiList(option)
设置 wifiList
中 AP 的相关信息。在 onGetWifiList
回调后调用,iOS特有接口。
注意
- 该接口只能在
onGetWifiList
回调之后才能调用。 - 此时客户端会挂起,等待小程序设置 Wi-Fi 信息,请务必尽快调用该接口,若无数据请传入一个空数组。
- 有可能随着周边 Wi-Fi 列表的刷新,单个流程内收到多次带有存在重复的 Wi-Fi 列表的回调。
类型
(option: Option) => Promise<WifiError>
参数
Option
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
wifiList | WifiData[] | 是 | 提供预设的 Wi-Fi 信息列表 |
complete | (res: WifiError) => void | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
fail | (res: WifiError) => void | 否 | 接口调用失败的回调函数 |
success | (res: WifiError) => void | 否 | 接口调用成功的回调函数 |
WifiData
提供预设的 Wi-Fi 信息列表
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
BSSID | string | 否 | Wi-Fi 的 BSSID |
SSID | string | 否 | Wi-Fi 的 SSID |
password | string | 否 | Wi-Fi 设备密码 |
示例代码
Taro.onGetWifiList(function (res) {
if (res.wifiList.length) {
Taro.setWifiList({
wifiList: [{
SSID: res.wifiList[0].SSID,
BSSID: res.wifiList[0].BSSID,
password: '123456'
}]
})
} else {
Taro.setWifiList({
wifiList: []
})
}
})
Taro.getWifiList()
API 支持度
API | 微信小程序 | H5 | React Native |
---|---|---|---|
Taro.setWifiList | ✔️ |