Taro.setWifiList(option)

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

注意

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

参考文档

类型

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

参数

Option

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

WifiData

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

参数类型必填说明
BSSIDstring否Wi-Fi 的 BSSID
SSIDstring否Wi-Fi 的 SSID
passwordstring否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()

API 支持度

API微信小程序H5React Native
Taro.setWifiList✔️