前言
最近我们上线了个小程序的项目,全国独家的~主要就是检测人身体的一些基本生命体征的,比如检测心电图、心率、血氧饱和度、血糖、尿酸等等,因为产品是我们自主研发的,硬件也是我们自己造的,所以软件也是由我们整个研发团队来研发。
目前的检测板只支持蓝牙协议
传输数据,需要小程序与检测板通过发送和接受指令来实现各项功能,趁热打铁,今天我就来整理一下我们在使用小程序中,是如何连接蓝牙的。
初始化蓝牙模块
在小程序中,要想使用蓝牙能力必须得先调用一下wx.openBluetoothAdapter
初始化蓝牙适配器模块,起生效周期为调用wx.openBluetoothAdapter
至调用 wx.closeBluetoothAdapter
或小程序销毁为止。
微信开放文档:
只有在小程序蓝牙适配器模块生效期间,开发者才能够正常调用蓝牙相关的小程序 API,并收到蓝牙模块相关的事件回调(绑定监听不受此限制)。小程序对蓝牙支持情况如下:
经典蓝牙
:iOS 因系统限制暂无法提供,安卓目前已在规划中。蓝牙低功耗 (BLE)
:主机模式
:基础库 1.1.0(微信客户端 iOS 6.5.6,Android 6.5.7)开始支持。从机模式
:基础库 2.10.3 开始支持。蓝牙信标 (Beacon)
:基础库 1.2.0 开始支持。
蓝牙连接的大致过程
1.初始化蓝牙设备
首先我们来调用一下初始化蓝牙模块的方法wx.openBluetoothAdapter
,在手机端为开启蓝牙或者小程序蓝牙授权背拒绝时,就会触发失败的回调,为了加强用户的有好体验,我们可以给其一个有效提醒。
代码如下:
wx.openBluetoothAdapter({
success: function (res) {
console.log("初始化蓝牙成功")
//查找蓝牙设备
findBlue();
},
fail: function (res) {
wx.showModal({
content: '请开启手机蓝牙!',
showCancel: false,
success (res) {}
})
}
})
注意:
其他蓝牙相关 API
必须在wx.openBluetoothAdapter
调用之后使用。否则 API
会返回错误(errCode=10000)。
2.搜索蓝牙设备
当我们初始化蓝牙模块成功后,下一步我们就可以搜索一下蓝牙设备了,我们需要调用这个方法wx.startBluetoothDevicesDiscovery
,调用该方法开始搜寻附近的蓝牙设备,此操作比较耗费系统资源,在搜索到需要的设备后,需要及时调用wx.stopBluetoothDevicesDiscovery
停止搜索。
相关代码如下:
const findBlue = model => {
wx.startBluetoothDevicesDiscovery({
services: ["xxxxxxxx", "0000FFB0-xxxxxx"],
interval: 0,
success: function (res) {
ConnectedDeviceRelated.isSearchBluetooth_detectionBoard = true
if (model != 'repeat' && e != 'notSearch') {
wx.showToast({
title: '正在搜索中...',
icon: 'none',
duration: 1500
})
}
//解决iOS第一次进入检测页面卡死的问题
setTimeout(function (params) {
getBluetoothDevices()
},500)
},
fail:function (res) {
console.log('搜索蓝牙设备错误',res)
if (res.errMsg == 'startBluetoothDevicesDiscovery:fail:location permission is denied') {
wx.showModal({
title: '警告',
content: '微信的位置权限被拒绝,请到设置中手动开启授权!',
showCancel: false,
success(res) {}
})
}
}
})
}
其中services
为要搜索的蓝牙设备主服务UUID
列表,某些蓝牙设备会广播自己的主service
的 UUID
。如果设置此参数,则只搜索广播包有对应 UUID 的主服务的蓝牙设备,可以通过该参数过滤掉周边不需要处理的其他蓝牙设备。
我的示例代码里面写的是XXX
,你可以根据你的实际情况而来。
注意
蓝牙功能需要用到定位权限,安卓微信 6.0
及以上版本,无定位权限或定位开关未打开时,无法进行设备搜索。这种情况下,安卓微信 8.0.16
前,接口调用成功但无法扫描设备;8.0.16
及以上版本,会返回错误。返回错误后,建议提示用户开启定位权限.
代码就是下面的这段,其实已经在上面放过了:
fail:function (res) {
console.log('搜索蓝牙设备错误',res)
if (res.errMsg == 'startBluetoothDevicesDiscovery:fail:location permission is denied') {
wx.showModal({
title: '警告',
content: '微信的位置权限被拒绝,请到设置中手动开启授权!',
showCancel: false,
success(res) {}
})
}
}
3.获取搜索到的蓝牙设备
上个方法我们是进行了搜索附近蓝牙设备,那么搜索到之后我们怎么办?我们就将其获取出来,以供在业务场景中使用。
获取在蓝牙模块生效期间所有搜索到的蓝牙设备,包括已经和本机处于连接状态的设备。当获取到你指定的设备后,要把蓝牙设备的设备id单独保存,在后面的操作中会用到。
代码如下:
//获取蓝牙设备信息
const getBluetoothDevices = () => {
wx.getBluetoothDevices({
success: function (res) {
if (res.devices.length > 0) {
for (var i = 0; i < res.devices.length; i++) {
if (res.devices[i].localName == ConnectedDeviceRelated.inputValue) {
console.log('看一下获取到的指定设备', res.devices[i])
ConnectedDeviceRelated.deviceId = res.devices[i].deviceId
app.globalData.deviceId = res.devices[i].deviceId
app.globalData.bluetooth = res.devices[i].localName
createBLEConnection()
break;
}
if (res.devices.length - 1 == i) {
findBlue('repeat')
}
}
} else {
findBlue('repeat')
}
},
fail: function () {
console.log("搜索蓝牙设备失败")
}
})
}
下图就是我们获取到的设备打印信息:
至此,小程序中初始化设备、到搜索设备,再到展示设备,都已经完成,后面的功能我写完了之后在发出来。