# 无线局域网 (Wi-Fi)

在小程序中支持搜索周边的 Wi-Fi 设备,同时可以针对指定设备,传入密码发起连接。

该系列接口为系统原生能力,如需查看「微信连 Wi-Fi」能力及配置跳转小程序,请参考文档

# 1. 连接指定 Wi-Fi 设备

如果知道 Wi-Fi 设备名称和密码,并确认设备在附近,可以直接在小程序中连接指定 Wi-Fi。

接口调用时序为:

  1. startWifi: 初始化 Wi-Fi 模块
  2. connectWifi: 连接 Wi-Fi(iOS 需 11 及以上版本支持)
  3. onWifiConnected: 连接上 Wi-Fi 的事件回调

# 2. 连接周边 Wi-Fi 设备

小程序可以通过扫描附近的 Wi-Fi 设备,让用户选择某个设备进行连接。

由于系统限制,不同平台下接口调用时序有所差异:

Android

  1. startWifi: 初始化 Wi-Fi 模块
  2. getWifiList: 请求获取周边 Wi-Fi 列表
  3. onGetWifiList: 获取到 Wi-Fi 列表数据事件
  4. connectWifi: 连接 Wi-Fi
  5. onWifiConnected: 连接上 Wi-Fi 的事件回调

iOS

  1. startWifi: 初始化 Wi-Fi 模块
  2. getWifiList: 请求获取周边 Wi-Fi 列表。本接口会跳转到系统设置中的微信设置页,需引导用户进入「无线局域网」设置页,手动连接设备。(iOS 11.0 及 11.1 版本因系统问题失效)
  3. onGetWifiList: 获取到 Wi-Fi 列表数据事件
  4. setWifiList: 设置 Wi-Fi 列表 中 AP 的相关信息,辅助用户进行连接
  5. onWifiConnected: 连接上 Wi-Fi 的事件回调

# 3. 注意事项

  • Android 系统 6.0 以上版本,在没有打开定位开关的时候会导致设备不能正常获取周边的 Wi-Fi 信息。
  • Wi-Fi 相关接口暂不可用 wx.canIUse 接口判断。