基础库 1.1.0 开始支持,低版本需做兼容处理。
以 Promise 风格 调用:支持
用户授权:需要 scope.bluetooth
小程序插件:支持,需要小程序基础库版本不低于 1.9.6
第一步:初始化蓝牙适配器 wx.openBluetoothAdapter
初始化蓝牙模块。iOS 上开启主机/从机(外围设备)模式时需分别调用一次,并指定对应的 mode
。
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|---|
mode | string | central | 否 | 蓝牙模式,可作为主/从设备,仅 iOS 需要。 | 2.10.0 |
success | function | 否 | 接口调用成功的回调函数 | ||
fail | function | 否 | 接口调用失败的回调函数 | ||
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
mode属性合法值为:
合法值 | 说明 |
---|---|
central | 主机模式 |
peripheral | 从机(外围设备)模式 |
其中进行监听蓝牙连接状态 wx.onBLEConnectionStateChange
监听蓝牙低功耗连接状态改变事件。包括开发者主动连接或断开连接,设备丢失,连接异常断开等等
参数
function listener
蓝牙低功耗连接状态改变事件的监听函数
参数
Object res
属性 | 类型 | 说明 |
---|---|---|
deviceId | string | 蓝牙设备 id |
connected | boolean | 是否处于已连接状态 |
官方文档:wx.openBluetoothAdapter(Object object) | 微信开放文档
// 初始化
initBlue: function (e) {
const that = this;
wx.openBluetoothAdapter({
success: (res) => {
that.setData({
"setInfo.initBlueText": "蓝牙初始化成功",
});
// 监听蓝牙连接状态改变
wx.onBLEConnectionStateChange(function (res) {
// 从连接状态断开
if (!res.connected) {
that.setData({
setInfo: {
connected: "已断开",
},
});
return;
}
});
this.findBlue(); // 搜索周边
},
fail: (res) => {
that.setData({
"setInfo.initBlueText":
"蓝牙初始化失败,请在手机设置中打开蓝牙以使用该功能",
});
//如果手机上的蓝牙没有打开,可以提醒用户
if (!that.data.openDoor) {
wx.showModal({
title: "提示",
content: "请在手机设置中打开蓝牙以使用该功能",
showCancel: false,
confirmText: "我已打开",
success(res) {
if (res.confirm) {
that.refresh();
}
},
});
}
},
});
},
调用 wx.openBluetoothAdapter api初始化蓝牙模块。
注意:
- 后面其他的蓝牙相关api,必须要在 wx.openBluetoothAdapter 初始化过后才能调用,不然要报错
- 如果手机蓝牙没有打开的话会在 wx.openBluetoothAdapter 的 fail 里面返回错误信息errCode=10001
- 此功能只有在手机调试或者预览的时候才能使用
- 如果需要监听蓝牙连接的状态需要使用 wx.onBLEConnectionStateChange 来监听并且需要在蓝牙初始化成功过后再调用,当断开连接连接的时候可以实时监听,并做出相应的提示给用户。
- this 会随着上下文环境而变换它的指向,所以在当前作用域中设置一个变量用来存储 this 可以防止在其他地方找不到 this 的错误。