小程序---蓝牙之旅(门禁小程序)
2018年8月 飘雨的八月
一 版本支持
基础库版本 1.1.0 开始支持，低版本需做兼容处理
iOS 微信客户端 6.5.6 版本开始支持，Android 6.5.7 版本开始支持
目前不支持在开发者工具上进行调试，需要使用真机才能正常调用小程序蓝牙接口
二 API简介
蓝牙API一共有18个
1.操作蓝牙适配器---4个
wx.openBluetoothAdapter 初始化蓝牙适配器
wx.closeBluetoothAdapter 关闭蓝牙模块
wx.getBluetoothAdapterState 获取本机蓝牙适配器状态
wx.onBluetoothAdapterStateChange 监听蓝牙适配器状态变化事件
2.连接前使用---- 4个
wx.startBluetoothDevicesDiscovery 开始搜寻附近的蓝牙外围设备
wx.stopBluetoothDevicesDiscovery停止搜寻附近的蓝牙外围设备
wx.getBluetoothDevices 获取所有已发现的蓝牙设备
wx.onBluetoothDeviceFound监听寻找到新设备的事件
3.连接和断开时使用----2个
wx.createBLEConnection连接低功耗蓝牙设备
wx.closeBLEConnection 断开与低功耗蓝牙设备的连接
4.连接成功后使用-----8个
wx.getConnectedBluetoothDevices根据 uuid 获取处于已连接状态的设备
wx.getBLEDeviceServices获取蓝牙设备所有 service（服务）
wx.getBLEDeviceCharacteristics 获取蓝牙设备所有 characteristic（特征值）
wx.readBLECharacteristicValue 读取低功耗蓝牙设备的特征值的二进制数据值
wx.writeBLECharacteristicValue 向低功耗蓝牙设备特征值中写入二进制数据
wx.notifyBLECharacteristicValueChange 启用低功耗蓝牙设备特征值变化时的 notify 功能
wx.onBLECharacteristicValueChange 监听低功耗蓝牙设备的特征值变化
wx.onBLEConnectionStateChange 监听低功耗蓝牙连接的错误事件
个人认为合理的操作流程
1.初始化蓝牙适配器:wx.openBluetoothAdapter (),初始化蓝牙适配器之前要进行版本判定.
2.开始搜寻附近的蓝牙外围设备:wx.startBluetoothDevicesDiscovery(OBJECT),可以通过主服务的UUID,来过滤设备,如果你知道UUID的话
Tip:android情况下,知道设备的mac地址可以跳过该步骤,直接连接;ios不能跳过任何步骤
3.监听寻找到新设备的事件wx.onBluetoothDeviceFound(CALLBACK)
Tip:每搜索到一个设备则执行一次,该函数可以得到设备的各种信息:设备名,deviceId(mac/uuid),RSSI(信号强)等等
4.连接低功耗蓝牙设备wx.createBLEConnection(OBJECT),此函数只需要一个参数(MAC/UUID),意外断开可用wx.onBLEConnectionStateChange()监听并重连
Tip:连接成功请马上调用wx.stopBluetoothDevicesDiscovery(OBJECT) 停止搜寻附近的蓝牙外围设备
5.获取蓝牙设备所有 service（服务）wx.getBLEDeviceServices(OBJECT),此函数需要只一个参数deviceId,返回两个参数:services:设备服务列表,errMsg:成功则是ok，错误则是详细信息
Tip:service设备服务列表有两个对象,分别是uuid(蓝牙设备服务的 uuid),isPrimary(该服务是否主服务),不同的服务可以跟不同的设备进行通信,并且每个服务包含了一组特征值(characteristic)可以认为是一种类型的，类似于一个类,我们可以通过uuid来确认自己所需要的服务
6.获取蓝牙设备某个服务中的所有 characteristic（特征值）wx.getBLEDeviceCharacteristics(OBJECT),此函数需要两个参数:deviceId(mac/uuid),serviceId(蓝牙服务 uuid,这个参数由5获取),返回:characteristics( Array 设备特征值列表)
Tip:characteristic包含两个对象,分别是uuid(蓝牙设备特征值的 uuid ),properties(该特征值支持的操作类型read,write,notify,indicate)
7.wx.notifyBLECharacteristicValueChange(OBJECT)启用低功耗蓝牙设备特征值变化时的 notify 功能，订阅特征值。注意：必须设备的特征值支持notify或者indicate才可以成功调用,先启用notify才能监听到设备 characteristicValueChange 事件,此函数需要三个参数分别是:deviceId(mac/uuid),serviceId(蓝牙服务的uuid由5获取),characteristicId(蓝牙特征值的 uuid,由6获取),注:state:true 必须要有
8.wx.writeBLECharacteristicValue(OBJECT)向低功耗蓝牙设备特征值中写入二进制数据,此函数要经过7开启notify才能正常进行,每次写入数据不得超20字节,除非进行分包.需要4个参数:deviceId(mac/uuid),serviceId(蓝牙服务的uuid由5获取),characteristicId(蓝牙特征值的 uuid,由6获取),value(必需是ArrayBuffer类型),ArrayBuffer无法正常vConsole 打印,如果你打印出来的是一个对象,证明你是成功的ArrayBuffer类型了.
9.wx.onBLECharacteristicValueChange(CALLBACK)监听低功耗蓝牙设备的特征值变化。必须先启用notify接口才能接收到设备推送的notification。此函数返回的value(ArrayBuffer类型)就是设备返回的数,但必需转换成符串才能打印,
10.断开与低功耗蓝牙设备的连接wx.closeBLEConnection(OBJECT),wx.closeBluetoothAdapter(OBJECT)关闭蓝牙模块，使其进入未初始化状态。流程走后,需要断开连接并关闭蓝牙模块释放系统资源.前一个函数需要一个参数:mac/uuid.
注:搜索,过滤,停止搜索,重连请灵活搭配食用
实践可用干货:
十六进制字符串===>ArrayBuffer
function hexStringToArrayBuffer(hexStr) {
var count = hexStr.length / 2;
let buffer = new ArrayBuffer(count);
let dataView = new DataView(buffer);
for (var i = 0; i < count; i++) {
var curCharCode = parseInt(hexStr.substr(i * 2, 2), 16);
dataView.setUint8(i, curCharCode);
}
return buffer;
}
ArrayBuffer===>16进度字符串
function ab2hex(buffer) {
return Array.prototype.map.call(new Uint8Array(buffer), x => ('00' + x.toString(16)).slice(-2)).join('');
}
**支持蓝牙 API 的版本,Android从微信 6.5.7 开始支持，iOS从微信 6.5.6 开始支持**
compareVersion: function(v1, v2) {
v1 = v1.split('.')
v2 = v2.split('.')
var len = Math.max(v1.length, v2.length)
while (v1.length < len) {
v1.push('0')
}
while (v2.length < len) {
v2.push('0')
}
for (var i = 0; i < len; i++) {
var num1 = parseInt(v1[i])
var num2 = parseInt(v2[i])
if (num1 > num2) {
return 1
} else if (num1 < num2) {
return -1
}
}
return 0
}
(return != 1 提示版本过低)
至于demo暂时还不能贴出来,一些手机在开启蓝牙的时候,要延迟2秒才可以扫描,连接,读取特征值等,这一点大家视情况而定延迟时间,本次实践的是小米6与苹果5S,若文章出错,请大家小喷提出...
