# 无线局域网 (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 接口判断。