微信小程序提供了支持 Wi-Fi 功能的多个 Api 接口。查看 Api 接口详情，请移步：微信小程序 Wi-Fi
最近在做物联网项目，项目中需要使用 Wi-Fi 相关功能。由于项目接近尾声，所以总结一下微信小程序 Wi-Fi 的使用方法，以及遇到的一些问题。
使用方法
一、 若已知要连接 Wi-Fi 的账号密码，需要两步
初始化 Wi-Fi -> 连接 Wi-Fi
wx.startWifi() -> wx.connectWifi()
二、 若要获取 Wi-Fi 列表，Android 与 iOS 有所不同
iOS 需要四步
初始化 Wi-Fi -> 请求获取 Wi-Fi 列表 -> 监听获取到 Wi-Fi 列表数据事件 -> 连接 Wi-Fi
wx.startWifi() -> wx.getWifiList() -> wx.onGetWifiList() -> wx.connectWifi()Android 需要五步
初始化 Wi-Fi -> 授权用户地理位置 -> 请求获取 Wi-Fi 列表 -> 监听获取到 Wi-Fi 列表数据事件 -> 连接 Wi-Fi
wx.startWifi() -> scope.userLocation -> wx.getWifiList() -> wx.onGetWifiList() -> wx.connectWifi()
三、实现代码
const app = getApp();
var platform;
var wifiList = [];
var callBackFunc;
// 仅 Android 6 与 iOS 11 以上版本支持
function checkPlatform() {
return new Promise((resolve, reject) => {
// 检测手机型号
wx.getSystemInfo({
success: function(res) {
var system = '';
if (res.platform == 'android') system = parseInt(res.system.substr(8));
if (res.platform == 'ios') system = parseInt(res.system.substr(4));
if (res.platform == 'android' && system < 6) {
reject();
}
if (res.platform == 'ios' && system < 11) {
reject();
}
platform = res.platform
resolve(res.platform);
},
fail: function(res) {
wx.showToast({
title: '请求失败',
icon: "none",
duration: 3000
})
}
})
})
}
// 1. 可直接使用该方法去连接 Wi-Fi
function startConnectWifi(account, password) {
return new Promise((resolve, reject) => {
wx.startWifi({
success(res) {
connectWifi(account, password).then(() => {
resolve()
}).catch((res) => {
reject(res)
})
},
fail(res) {
wx.showToast({
title: '初始化WiFi失败',
icon: "none",
duration: 3000
})
reject()
}
})
})
}
// 2. 可直接使用该方法去搜索 Wi-Fi
function startSearchWifi(func) {
callBackFunc = func
startWifi()
}
// 初始化 WiFi 模块
function startWifi() {
wx.startWifi({
success(res) {
getWifiListFunc();
},
fail(res) {
wx.showToast({
title: '初始化WiFi失败',
icon: "none",
duration: 3000
})
}
})
}
// 请求获取 WiFi 列表
function getWifiListFunc() {
if (platform == 'ios') {
getWifiList();
} else {
wx.getSetting({
success(res) {
//地理位置
if (!res.authSetting['scope.userLocation']) {
wx.authorize({
scope: 'scope.userLocation',
success(res) {
getWifiList();
},
fail(res) {
wx.showModal({
title: '提示',
content: '定位失败，您未开启定位权限，点击开启定位权限',
success: function(res) {
if (res.confirm) {
wx.openSetting({
success: function(res) {
if (res.authSetting['scope.userLocation']) {
getWifiList();
} else {
wx.showToast({
title: '用户未开启地理位置权限',
icon: "none",
duration: 3000
})
}
}
})
}
}
})
}
})
} else {
getWifiList();
}
}
})
}
}
function getWifiList() {
wx.getWifiList({
success: function(res) {
// 监听获取到 WiFi 列表数据事件
wx.onGetWifiList(function(res) {
wifiList = []
let tmpList = []
if (res && res.wifiList) {
res.wifiList.map(item => {
if (tmpList.indexOf(item.SSID) == -1) {
tmpList.push(item.SSID)
wifiList.push(item)
}
})
callBackFunc(wifiList)
}
})
},
fail: function(res) {
wx.showToast({
title: '获取 Wi-Fi 列表数据失败',
icon: "none",
duration: 3000
})
}
})
}
// 连接 WiFi。若已知 WiFi 信息，可以直接利用该接口连接。仅 Android 与 iOS 11 以上版本支持
function connectWifi(account, password) {
return new Promise((resolve, reject) => {
let wifiCount = 0
let wifiTimer = setInterval(() => {
wifiCount++
if (wifiCount >= 30) {
clearInterval(wifiTimer)
reject()
}
}, 1000)
// 获取当前网络的名称
getConnectedWifi().then((res) => {
if (res.SSID == account) {
clearInterval(wifiTimer)
resolve()
} else {
// 值得注意的是：ios 无论连网成功还是失败，都会走 success 方法，所以 ios 需要特别判断一下
wx.connectWifi({
SSID: account,
password: password,
success(res) {
// ios 判断当前手机已连网账号与要连网的账号是否一致，来确定是否连网成功
if (platform == 'ios') {
// 6.监听连接上 WiFi 的事件
wx.onWifiConnected(function(res) {
clearInterval(wifiTimer)
if (res.wifi.SSID == account) {
resolve()
} else {
reject()
}
})
// wx.getConnectedWifi({
// success: res => {
// clearInterval(wifiTimer)
// if (res.wifi.SSID == account) {
// console.log('ios getConnectedWifi成功..........', account)
// resolve()
// } else {
// console.log('ios getConnectedWifi失败..........', account)
// reject()
// }
// },
// fail: res => {
// clearInterval(wifiTimer)
// reject(res)
// }
// })
} else {
clearInterval(wifiTimer)
resolve()
}
},
fail(res) {
clearInterval(wifiTimer)
reject(res)
}
})
}
}).catch((res) => {
clearInterval(wifiTimer)
reject(res)
})
})
}
// 获取当前网络的名称
function getConnectedWifi() {
return new Promise((resolve, reject) => {
wx.getConnectedWifi({
success: res => {
resolve(res.wifi)
},
fail: res => {
reject(res)
}
})
})
}
export default {
checkPlatform: checkPlatform, // 检测平台是否支持
startConnectWifi: startConnectWifi, // 开始连接已知网络
startSearchWifi: startSearchWifi, // 开始搜索周边网络
connectWifi: connectWifi, // 连接网络
getConnectedWifi: getConnectedWifi // 获取当前网络的名称
}
遇到的问题
wx.connectWifi() 方法
iOS 无论连网成功还是失败，都会走 success 方法，所以 iOS 需要加一层判断。目前是使用了 wx.onWifiConnected() 方法判断，这个方法有个问题，只有成功的时候才会走回调，失败的时候没有回调。本来是想用 wx.getConnectedWifi() 方法判断的，但是用这个方法也有问题，就是手机网络在切换的时候，会有短时间的无网络状态，而这个时候如果调用这个方法，会弹出无法连接网络的弹框。小程序连网 Api 没有对部分安卓手机做好兼容
测试的时候发现，部分华为 mate30 和 小米5X 在调用 wx.connectWifi() 方法的时候，会报连接超时的错误。
