前言:
记得上次分享过一篇小程序的文章《时隔两年,我开始学习微信小程序了~~仿小米手机天气预报》,那是我首次学习小程序,转眼间又过去大半年了,这次我就来谈谈--->小程序蓝牙开发。
一、你了解蓝牙吗?
蓝牙是一种无线技术标准,可实现固定设备、移动设备和楼宇个人域网之间的短距离数据交换(使用2.4—2.485GHz的ISM波段的UHF无线电波)。蓝牙技术最初由电信巨头爱立信公司于1994年创制,当时是作为RS232数据线的替代方案。蓝牙可连接多个设备,克服了数据同步的难题。
相信负责移动端开发的朋友们或大或小都有了解过“经典蓝牙”和“低功耗蓝牙”这两个代名词;而我总结了一下他们的优缺点:
1、android手机必须系统版本4.3及以上才支持BLE API。BLE蓝牙较传统蓝牙, 传输速度更快,覆盖范围更广,安全性更高,延迟更短,耗电极低等等优点;
2、传统蓝牙与BLE蓝牙通信方式也有所不同,传统的一般通过socket方式,而BLE蓝牙是通过Gatt协议来实现;
3、传统蓝牙可以用与数据量比较大的传输,如语音,音乐,较高数据量传输等;
低功耗蓝牙这样应用于实时性要求比较高,但是数据速率比较低的产品,如遥控类的,如鼠标,键盘,遥控鼠标(Air Mouse),传感设备的数据发送,如心跳带,血压计,温度传感器等一些医疗器械。
二、小程序蓝牙开发
一直以来我都是负责Android端的蓝牙软件项目开发,突然间某某某领导对我说要用小程序开发,那时我心中有一百个不爽,由于小程序的API已经对蓝牙提供支持了,我也没有什么理由去推卸了,但我只能说对领导说关于小程序蓝牙开发还不够成熟,其中可能会有兼容性问题,对于可行性问题我也不太确定,所以我也是抱着学习的心态去面对的。开始行动起来吧,相信敢于挑战,敢于付出的人,肯定有所收获的。
首先小程序开发 离不开小程序开发文档:先去了解和熟悉蓝牙API;都看一遍,对整个蓝牙开发流程也不过如此简单,都是一些api的套路罢了。
微信客户端对小程序蓝牙的支持版本为:iOS 微信客户端 6.5.6 版本开始支持,Android微信客户端 6.5.7 版本开始支持,此外还需要注意的就是Android系统需要Android4.3以上才可以使用蓝牙BLE,而小程序蓝牙只支持BLE,这点需要注意下。
1.获取当前设备平台以及微信版本,判断是否支持小程序蓝牙:
//获取当前设备平台以及微信版本
if (app.getPlatform() == 'android' && this.versionCompare('6.5.7', app.getWxVersion())) {
wx.showModal({
title: '提示',
content: '当前微信版本过低,请更新至最新版本',
showCancel: false,
success: function (res) {
if (res.confirm) {
that.backPage();
}
}
})
} else if (app.getPlatform() == 'ios' && this.versionCompare('6.5.6', app.getWxVersion())){
wx.showModal({
title: '提示',
content: '当前微信版本过低,请更新至最新版本',
showCancel: false,
success: function (res) {
if (res.confirm) {
that.backPage();
}
}
})
}
2.初始化小程序蓝牙模块,生效周期为调用wx.openBluetoothAdapter
至调用wx.closeBluetoothAdapter
或小程序被销毁为止。 在小程序蓝牙适配器模块生效期间,开发者可以正常调用下面的小程序API,并会收到蓝牙模块相关的on回调。
//初始化小程序蓝牙模块
openBluetoothAdapter:function(){
var that = this;
wx.openBluetoothAdapter({
success: function (res){
var log = that.data.textLog + "打开蓝牙适配器成功!\n";
that.setData({
textLog: log,
isopen:true
});
that.getBluetoothAdapterState();
},
fail: function (err){
isopen: true;
app.toastTap("蓝牙开关未开启");
var log = that.data.textLog + "蓝牙开关未开启 \n";
that.setData({
textLog: log
});
}
})
//监听蓝牙适配器状态变化事件
wx.onBluetoothAdapterStateChange(function (res) {
console.log('onBluetoothAdapterStateChange', res)
var isDvailable = res.available;//蓝牙适配器是否可用
if (isDvailable) {
that.getBluetoothAdapterState();
} else {
that.stopBluetoothDevicesDiscovery();//停止搜索
that.setData({
devices: []
});
app.toastTap1("蓝牙开关未开启");
}
})
}
3.获取本机蓝牙适配器状态
getBluetoothAdapterState: function () {
var that = this;
wx.getBluetoothAdapterState({
success: function (res) {
var isDiscov = res.discovering;//是否正在搜索设备
var isDvailable = res.available;//蓝牙适配器是否可用
if (isDvailable) {
var log = that.data.textLog + "本机蓝牙适配器状态:可用 \n";
that.setData({
textLog: log
});
if (!isDiscov){
that.startBluetoothDevicesDiscovery();
}else{
var log = that.data.textLog + "已在搜索设备 \n";
that.setData({
textLog: log
});
}
}
}
})
}
4.开始扫描附近的蓝牙外围设备。注意,该操作比较耗费系统资源,请在搜索并连接到设备后调用 stop 方法停止搜索。
wx.startBluetoothDevicesDiscovery({
services: [],// 以微信硬件平台的蓝牙智能灯为例,主服务的 UUID 是 FEE7。传入这个参数:services: ['FEE7'],只搜索主服务 UUID 为 FEE7 的设备
allowDuplicatesKey: true, //是否允许重复上报同一设备, 如果允许重复上报,则onDeviceFound 方法会多次上报同一设备,但是 RSSI(信号) 值会有不同
success: function (res) {
var log = that.data.textLog + "扫描附近的蓝牙外围设备成功,准备监听寻找新设备:" + res+"\n";
that.setData({
textLog: log
});
that.onBluetoothDeviceFound(); //监听寻找到新设备的事件
}
});
5.监听寻找到新设备的事件;Android 上获取到的deviceId
为设备 MAC 地址,iOS 上则为设备 uuid。因此deviceId
不能硬编码到代码中
//监听寻找到新设备的事件
onBluetoothDeviceFound:function() {
var that = this;
wx.onBluetoothDeviceFound(function(res) {
res.devices.forEach(function (device) {
if (!device.name && !device.localName) {
return
}
const foundDevices = that.data.devices;
const idx = inArray(foundDevices, 'deviceId', device.deviceId);
const data = {};
if (idx === -1) {
data[`devices[${foundDevices.length}]`] = device
} else {
data[`devices[${idx}]`] = device
}
that.setData(data)
})
})
}
至此整个过程就完成了对设备的搜索操作,这时就可以对扫描到的设备id以及name,进行处理;不过这个过程需要注意的是:安卓和IOS差别很大,安卓设备地址就是mac地址,但是IOS无法获取mac地址,所以设备地址是针对本机范围有效的UUID,所以这里需要注意。剩下的就是蓝牙设备的连接、读、写、还有监听获取返回值了。
6.连接低功耗蓝牙设备。
wx.createBLEConnection({ // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
deviceId: deviceId,
success: function (res) {
console.log(res)
}
})
当使用此方法成功连接蓝牙设备后,需要使用方法:wx.stopBluetoothDevicesDiscovery() 关闭蓝牙扫描功能,释放资源,减少消耗。
7.获取蓝牙设备所有 service(服务)
//获取蓝牙设备所有 service(服务)
getBLEDeviceServices:function(devId) {
var that = this;
wx.getBLEDeviceServices({
deviceId:devId,
success: function(res) {
for (let i = 0; i < res.services.length; i++) {
if (res.services[i].isPrimary) {//该服务是否为主服务
var log = that.data.textLog + "该服务是否为主服务:" + res.services[i].isPrimary + "\n";
that.setData({
textLog: log
});
}
}
}
})
}
8.获取到服务ID后,就可以获取蓝牙设备某个服务中的所有 characteristic(特征值)
//获取蓝牙设备某个服务中的所有 characteristic(特征值)
getBLEDeviceCharacteristics: function (deviceId, serviceId){
var that = this;
wx.getBLEDeviceCharacteristics({
deviceId: deviceId,
serviceId: serviceId,
success: function (res) {
for (let i = 0; i < res.characteristics.length; i++) {
let item = res.characteristics[i]
if (item.properties.read) {//该特征值是否支持 read 操作
var log = that.data.textLog + "该特征值支持 read 操作:" + item.uuid + "\n";
that.setData({
textLog: log,
readCharacteristicId: item.uuid
});
}
if (item.properties.write) {//该特征值是否支持 write 操作
var log = that.data.textLog + "该特征值支持 write 操作:" + item.uuid + "\n";
that.setData({
textLog: log,
writeCharacteristicId: item.uuid,
canWrite:true
});
}
if (item.properties.notify) {//该特征值是否支持 notify或indicate 操作
var log = that.data.textLog + "该特征值支持 notify 操作:" + item.uuid + "\n";
that.setData({
textLog: log,
notifyCharacteristicId: item.uuid,
});
that.notifyBLECharacteristicValueChange();
}
}
}
})
}
至此,我们已经获取了 读的特征值UUID,有些设备不支持读操作的话,就没有这个UUID;我们还获取了写操作的UUID,如果没有此UUID的话,我们的设备就不支持写入指令操作;我们还获取了notify UUID,是用来执行广播监听事件的,就是写入指令后,蓝牙设备有返回数值,都可以监听接收。
9.开启监听蓝牙设备的返回值,读写操作成功后的返回值也是在下面onBLECharacteristicValueChange这个方法获取,这里相当于Android蓝牙BLE的开启广播监听。
notifyBLECharacteristicValueChange:function(){
var that = this;
wx.notifyBLECharacteristicValueChange({
state: true, // 启用 notify 功能
deviceId: that.data.deviceId,
serviceId: that.data.serviceId,
characteristicId: that.data.notifyCharacteristicId,
success: function (res) {
var log = that.data.textLog + "notify启动成功\n";
that.setData({
textLog: log,
});
that.onBLECharacteristicValueChange(); //监听特征值变化
},
fail: function (res) {
wx.showToast({
title: 'notify启动失败',
mask: true
});
setTimeout(function () {
wx.hideToast();
}, 2000)
}
})
},
//监听低功耗蓝牙设备的特征值变化。必须先启用notify接口才能接收到设备推送的notification。
onBLECharacteristicValueChange:function(){
var that = this;
var log = that.data.textLog + "准备监听低功耗蓝牙设备的特征值变化\n";
that.setData({
textLog: log,
});
wx.onBLECharacteristicValueChange(function (res) {
var log = that.data.textLog + "监听低功耗蓝牙设备的特征值变化\n";
that.setData({
textLog: log,
});
// var resValue = that.ab2hext(res.value); //16进制字符串
});
}
10.最后一步,读或写操作;这里需要注意的是:小程序中对蓝牙数据的传递是使用ArrayBuffer的二进制类型来的,所以在我们的使用过程中需要进行转码再进行读或者写操作。
//读
wx.readBLECharacteristicValue({
// 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接 [**new**]
deviceId: deviceId,
// 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
serviceId: serviceId,
// 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取
characteristicId: characteristicId,
success: function (res) {
console.log('readBLECharacteristicValue:', res.errCode)
}
})
、、、、、
//写
wx.writeBLECharacteristicValue({
// 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
deviceId: deviceId,
// 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
serviceId: serviceId,
// 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取
characteristicId: characteristicId,
// 这里的value是ArrayBuffer类型
value: buffer,
success: function (res) {
console.log('writeBLECharacteristicValue success', res.errMsg)
}
})
、、、、、
//写
wx.writeBLECharacteristicValue({
// 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
deviceId: deviceId,
// 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
serviceId: serviceId,
// 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取
characteristicId: characteristicId,
// 这里的value是ArrayBuffer类型
value: buffer,
success: function (res) {
console.log('writeBLECharacteristicValue success', res.errMsg)
}
}
)
查看小程序蓝牙api也会发现如下tip:
就是要控制单次传送的指令,确保不要超过20个字节,如果超过了,就要进行分包发送了,也就是每次分20个字节,分成多次发送,如果是Android开发的话,可以调整MTU的大小,但是小程序没有封装这个方法,所以只能分包也是可以的。
在学习小程序蓝牙的过程中,我也写了个demo:小程序蓝牙demo,希望能帮助到大家,并且也能趁此机会和大家交流,望多多指教。