title: Taro.setWifiList(option)

sidebar_label: setWifiList

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

注意

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

支持情况:setWifiList - 图1 setWifiList - 图2 setWifiList - 图3

参考文档

类型

  1. (option: Option) => Promise<TaroGeneral.WifiError>

参数

参数 类型
option Option

Option

参数 类型 必填 说明
wifiList WifiData[] 提供预设的 Wi-Fi 信息列表
complete (res: TaroGeneral.WifiError) => void 接口调用结束的回调函数(调用成功、失败都会执行)
fail (res: TaroGeneral.WifiError) => void 接口调用失败的回调函数
success (res: TaroGeneral.WifiError) => void 接口调用成功的回调函数

WifiData

提供预设的 Wi-Fi 信息列表

参数 类型 必填 说明
BSSID string Wi-Fi 的 BSSID
SSID string Wi-Fi 的 SSID
password string Wi-Fi 设备密码

示例代码

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