微信小程序 - 蓝牙连接

小程序 0

一、蓝牙介绍

官网 蓝牙 (Bluetooth) | 微信开放文档

       蓝牙低功耗是从蓝牙 4.0 起支持的协议,与经典蓝牙相比,功耗极低、传输速度更快,但传输数据量较小。常用在对续航要求较高且只需小数据量传输的各种智能电子产品中,比如智能穿戴设备、智能家电、传感器等,应用场景广泛。

1. 角色/工作模式

蓝牙低功耗协议给设备定义了若干角色,或称工作模式。小程序蓝牙目前支持的有以下几种:

1) 中心设备/主机 (Central)

中心设备可以扫描外围设备,并在发现有外围设备存在后与之建立连接,之后就可以使用外围设备提供的服务(Service)。

一般而言,手机会担任中心设备的角色,利用外围设备提供的数据进行处理或展示等等。小程序提供低功耗蓝牙接口是默认设定手机为中心设备的。

2) 外围设备/从机 (Peripheral)

外围设备一直处于广播状态,等待被中心设备搜索和连接,不能主动发起搜索。例如智能手环、传感器等设备。

如果外围设备广播时被设置为不可连接的状态,也被称为广播模式 (Broadcaster),常见的例子是蓝牙信标 (Beacon) 设备。

注意

在小程序中,蓝牙设备可以同时处于主机和从机模式。在安卓设备上,只需要调用 wx.openBluetoothAdapter 初始化一次蓝牙适配器;而在 iOS 设备上,需要分别使用两种不同的 mode 参数分别初始化中心设备和外围设备的蓝牙适配器。建议统一对于主机和从机模式分别进行一次初始化。wx.closeBluetoothAdapter 会同时关闭两种模式的蓝牙适配器。

2. 通信协议

在两个蓝牙低功耗设备建立连接之后,双方的数据交互是基于 GATT (Generic Attribute Profile) 规范,根据该规范可以定义出一个个配置文件 (Profile),描述该蓝牙设备提供的服务 (Service)。

在整个通信过程中,有几个最主要的概念:

  • 配置文件 (Profile): Profile 是被蓝牙标准预先定义的一些 Service 的集合,并不真实存在于蓝牙设备中。如果蓝牙设备之间要相互兼容,它们只要支持相同的 Profile 即可。一个蓝牙设备可以支持多个 Profile。

  • 服务 (Service): Service 是蓝牙设备对外提供的服务,一个设备可以提供多个服务,比如电量信息服务、系统信息服务等。每个服务由一个 UUID 唯一标识。

  • 特征 (Characteristic): 每个 Service 包含 0 至多个 Characteristic。比如,电量信息服务就会有个 Characteristic 表示电量数据。Characteristic 包含一个值 (value)和 0 至多个描述符 (Descriptor) 组成。在与蓝牙设备通信时,主要就是通过读写 Characteristic 的 value 完成。 每个 Characteristic 由一个 UUID 唯一标识。

  • 描述符 (Descriptor): Descriptor 是描述特征值的已定义属性。例如,Descriptor 可指定人类可读的描述、特征值的取值范围或特定于特征值的度量单位。每个 Descriptor 由一个 UUID 唯一标识。

3. UUID (Universally Unique Identifier)

根据蓝牙 4.2 协议规范(Vol 3, Part B, section 2.5.1 UUID),UUID 是一个 128 位的唯一标识符,用来标识 Service 和 Characteristic 等。

为了减少存储和传输 128 位 UUID 值的负担,蓝牙技术联盟预分配了一批 UUID,这一批 UUID 拥有一个共同部分,被称为 Bluetooth Base UUID,即 00000000-0000-1000-8000-00805F9B34FB。因此,预分配的 UUID 也可以使用 16 位或 32 位表示,其中 16 位 UUID 最为常用。使用 16/32 位的 UUID 可以降低存储和传输的负载。开发者自定义的 UUID 应注意不能与预分配的 UUID 冲突。

在小程序中,wx.startBluetoothDevicesDiscovery 和 wx.getConnectedBluetoothDevices 的参数支持 16/32/128 位 UUID。在其他接口的参数中,

  • iOS 支持直接使用 16 位 和 128 位的 UUID;

  • Android 8.0.9 版本开始,支持直接使用 16/32/128 位 UUID;

  • Android 8.0.9 以下版本,只支持 128 位的 UUID,需要开发者手动补位到 128 位。补位方式如下

128位UUID = 16位UUID * 2^96 + Bluetooth Base UUID128位UUID = 32位UUID * 2^96 + Bluetooth Base UUID

例如

0x180F -> 0000180F-0000-1000-8000-00805F9B34FB

所有接口的返回值统一为 128 位 UUID。

二、微信小程序蓝牙api

官网 设备/蓝牙wx.stopBluetoothDevicesDiscovery(Object object) | 微信开放文档

主要用到API如下:

1.打开蓝牙适配器:wx.openBluetoothAdapter,后续所有蓝牙模块功能都需要先打开适配器才能进行

2.搜寻蓝牙设备:

        2.1 开始搜寻:wx.startBluetoothDevicesDiscovery,此功能比较消耗性能,如果搜索到特定设备可即时停止

        2.2 发现设备事件:wx.onBluetoothDeviceFound,在这儿添加实时更新设备列表业务代码

        2.3 停止扫描:wx.onBluetoothDeviceFound,停止扫描新的蓝牙设备,当蓝牙扫描到指令设备时,需要即时关闭扫描保证性能

        2.4 关闭发现设备事件监听:wx.offBluetoothDeviceFound

3.连接蓝牙设备: wx.createBLEConnection,通过传入蓝牙设备deviceId进行设备直连。这里的deviceId可通过上面扫描时wx.onBluetoothDeviceFound响应值获取

4.监听蓝牙设备连接状态:wx.onBLEConnectionStateChange: 包括开发者主动连接或断开连接,设备丢失,连接异常断开等等

5.获取蓝牙服务

        5.1 获取蓝牙低功耗设备所有服务: wx.getBLEDeviceServices,通过

        5.2 根据特定服务UUID查询所有特征:[wx.getBLEDeviceCharacteristics](wx.getBLEDeviceCharacteristics),

6.监听蓝牙数据(实时获取蓝牙跳绳回传的电量,跳绳数量等信息)

        6.1 订阅特征变化:wx.notifyBLECharacteristicValueChange,开启订阅后续才能监听到蓝牙数据变化

        6.2 监听特征值变化:wx.onBLECharacteristicValueChange,通过监听事件触发数据解析业务

7.发送数据(向蓝牙跳绳下发指令)

        7.1 下发指令:wx.writeBLECharacteristicValue,通过向蓝牙特定服务的对应特征值写入数据,完成交互。注意:要对应支持“write"属性的特征值

8.关闭蓝牙活动

        8.1 wx.stopBluetoothDevicesDiscovery(): 停止扫描新设备

        8.2 wx.offBluetoothDeviceFound():关闭扫描新设备监听事件

        8.3 wx.offBLECharacteristicValueChange():关闭特征值变化监听(数据监听)

        8.4 wx.offBLEConnectionStateChange():移除蓝牙低功耗连接状态改变事件的监听函数

        8.5 wx.closeBLEConnection: 断开蓝牙连接

        8.6 wx.closeBluetoothAdapter():关闭蓝牙适配器

三、连接流程

1、初始化蓝牙

初次加载,自动获取获取系统信息,检查蓝牙适配器是否可用

初始化蓝牙,提示蓝牙,开始自动搜索蓝牙设备

initBlue(){    var that = this;    wx.openBluetoothAdapter({//调用微信小程序api 打开蓝牙适配器接口      success: function (res) {        console.log(res)        wx.showToast({          title: '初始化成功',          icon: 'success',          duration: 800        })        that.findBlue();//2.0      },      fail: function (res) {//如果手机上的蓝牙没有打开,可以提醒用户        wx.showToast({          title: '请开启蓝牙',          icon: 'error',          duration: 1000        })      }    })  },

2、搜索蓝牙设备

把搜索到的设备保存在一个数组内,渲染在页面

显示设备名称和连接按钮

//搜索蓝牙设备,并开始连接    findBlue() {        var that = this        //开始搜索蓝牙        wx.startBluetoothDevicesDiscovery({            allowDuplicatesKey: false,            interval: 0,            success: function (res) {                console.log(res);                // wx.showLoading({                //     title: '正在搜索设备',                // })                // that.getBlue()//3.0            }        })        //页面渲染过滤后的蓝牙列表        wx.getBluetoothDevices({            success: function (res) {                console.log(res) //蓝牙列表                let arr = []                res.devices.forEach(item => {                    if (item.name != '未知设备' && item.name) {                        arr.push(item)                    }                })                that.setData({                    deviceList: arr                })                console.log(that.data.deviceList)            }        })    },

3、连接蓝牙与设备

点击连接按钮创建连接,获取设备信息

    connetBlueDeviceId(deviceid) {        this.setData({            deviceId: deviceid        })        var that = this;        wx.createBLEConnection({            // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接            deviceId: deviceid, //设备id            success: function (res) {                console.log("res", res)                that.setData({                    value: 100                })                setTimeout(() => {                    that.setData({                        isgo: true                    })                }, 1000)                // wx.showToast({                //     title: '连接成功',                //     icon: 'success',                //     duration: 800                // })                that.getServiceId() //5.0            },            fail(err) {                console.log(err);                if(err.errCode == -1){                    that.setData({                        value: 100                    })                    setTimeout(() => {                        that.setData({                            isgo: true                        })                    }, 1000)                    that.getServiceId() //5.0                }            }        })    },

4、获取蓝牙设备上所有服务

连接成功停止搜索,获取已连接蓝牙的服务

// 连接上需要的蓝牙设备之后,获取这个蓝牙设备的服务uuid    getServiceId() {        var that = this        wx.getBLEDeviceServices({            // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接            deviceId: that.data.deviceId,            success: function (res) {                console.log(res)                var item = res.services[2];                that.setData({                    services: item.uuid                })                that.getCharacteId(that.data.deviceId, that.data.services) //6.0            },            fail(err) {                console.log(err);            }        })    },

5、获取蓝牙设备某个服务中所有特征值

连接成功获取蓝牙设备服务和特征值(是否能读写)

//获取蓝牙设备某个服务中所有特征值    getCharacteId(deviceId, services) {        console.log(this.data.deviceId, this.data.services)        var that = this        wx.getBLEDeviceCharacteristics({            // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接            deviceId: that.data.deviceId,            // 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取            serviceId: that.data.services,            success: function (res) {                console.log(res)                for (var i = 0; i < res.characteristics.length; i++) { //2个值                    var item = res.characteristics[i];                    if (item.properties.indicate || item.properties.notify) {                        that.setData({                            propertiesuuId: item.uuid,                        })                        that.startNotice(that.data.propertiesuuId) //7.0                    }                    if (item.properties.write == true) {                        that.setData({                            writeId: item.uuid //用来写入的值                        })                    }                }            },            fail(err) {                console.log("getBLEDeviceCharacteristics", err);            }        })    },

6、创建连接,发送指令

startNotice(uuid) {        console.log(this.data.deviceId, this.data.services, uuid)        wx.notifyBLECharacteristicValueChange({            state: true, // 启用 notify 功能            deviceId: this.data.deviceId,            serviceId: this.data.services,            characteristicId: uuid, //第一步 开启监听 notityid  第二步发送指令 write            type: "notification",            success: (res) => {                console.log(res,"notify创建连接,发送指令")                this.exchange_mtu()            }        })    },

7、修改mtu

exchange_mtu() {        let that = this        wx.setBLEMTU({            deviceId: this.data.deviceId,            mtu: 247,            success: function (res) {                console.log(res,"mtu update success")                that.onble()            },            fail: function (res) {                console.log(res,"mtu update failed")            },            complete: function (res) {                console.log(res,"mtu update complete")            }        })    },//获取mtugetmtu() {        wx.getBLEMTU({            deviceId: this.data.deviceId,            writeType: 'write',            success(res) {                console.log(res)            }        })    },

8、监听设备返回

onble() {        let that = this        // ArrayBuffer转16进制字符串示例        function ab2hex(buffer) {            let hexArr = Array.prototype.map.call(                new Uint8Array(buffer),                function (bit) {                    return ('00' + bit.toString(16)).slice(-2)                }            )            return hexArr.join('');        }        function hex2a(hexx) {            var hex = hexx.toString(); //force conversion            var str = '';            for (var i = 0; i < hex.length; i += 2)                str += String.fromCharCode(parseInt(hex.substr(i, 2), 16));            return str;        }        wx.onBLECharacteristicValueChange(function (res) {            console.log(`characteristic ${res.characteristicId} has changed, now is ${res.value}`)            console.log(ab2hex(res.value))            console.log(hex2a(ab2hex(res.value)))        })    },

四、通过蓝牙查询配置设备参数

1、查询下发数据帧

compoundPack() {        let myData = {            cmdType: this.data.type,            mtu: "247",            devicecode: this.data.devicecode        }        http.post(http.compoundPack, myData).then((res, err) => {            console.log(res)            if (res.status) {                this.setData({                    dataPacks: res.data.dataPacks[0]                })                this.writeBleEvent()            }        })    },

2、将数据帧写入设备

//写入数据    writeBleEvent() {        console.log("开始写入值" + this.data.dataPacks);        var that = this;        var cell = {            "writeValue": this.data.dataPacks,        }        //蓝牙设备特征值对应的值,为 16 进制字符串,限制在 20 字节内。超过可使用分包        // var buffer = this.string2buffer(cell.writeValue);        var buffer = this.stringToHex(cell.writeValue);        setTimeout(function () {            var thisWriteDeviceId = that.data.deviceId;            var thisWriteServiceId = that.data.services;            var thisWriteCharacteristicId = that.data.writeId;            console.log(thisWriteDeviceId, thisWriteServiceId, thisWriteCharacteristicId, buffer)            wx.writeBLECharacteristicValue({                deviceId: thisWriteDeviceId,                serviceId: thisWriteServiceId,                characteristicId: thisWriteCharacteristicId,                value: buffer,                success: function (res) {                    console.log(res.errMsg);                    console.log("发送成功");                    that.onble()                },                fail: function (res) {                    console.log(res);                    console.log("发送失败." + res.errMsg);                    if (res.errCode == 10006) {                        that.setData({                            isconnect: false                        })                    }                },                complete: function () {}            }, 1000);        });    },

3、接收设备回复

console.log(stat,onble() {        let that = this        // ArrayBuffer转16进制字符串示例        function ab2hex(buffer) {            let hexArr = Array.prototype.map.call(                new Uint8Array(buffer),                function (bit) {                    return ('00' + bit.toString(16)).slice(-2)                }            )            return hexArr.join('');        }        function hex2a(hexx) {            var hex = hexx.toString(); //force conversion            var str = '';            for (var i = 0; i < hex.length; i += 2)                str += String.fromCharCode(parseInt(hex.substr(i, 2), 16));            return str;        }        wx.onBLECharacteristicValueChange(function (res) {            console.log('res', res)            console.log('hex:', ab2hex(res.value))            console.log('hex2astring:', hex2a(ab2hex(res.value)))            let view = new Uint8Array(res.value);            let stat            for (let i = 0; i < view.length; i++) {                if ((i + 1) <= view.length) {            ab2hex(stat))            if (stat) {                const getShort = (a, b) => a << 8 | b << 0                const firstShort = getShort(stat[11], stat[12])                 const secondShort = getShort(stat[12], stat[11])                console.log(firstShort, secondShort, '111')                let bitbufferlength = firstShort + 17                console.log(bitbufferlength,stat.length,'长度')                that.setData({                    bufferarr: stat                })                if (bitbufferlength == stat.length) {                    if (ab2hex(stat)) {                        that.frameParse(ab2hex(stat))                    }         if (view[i] == '0x7E' && view[i + 1] == '0x7E') {                        stat = view.subarray(i)                    }                }            }            console.log(stat,                }else if(bitbufferlength < stat.length){                    stat = stat.slice(0,bitbufferlength)                    console.log(stat,ab2hex(stat),'截取')                    that.frameParse(ab2hex(stat))                }            } else {                console.log(that.data.bufferarr, ab2hex(that.data.bufferarr), ab2hex(res.value), '拼接')                if (that.data.bufferarr.length > 0 && (ab2hex(res.value).indexOf('0d0a') == -1)) {                    that.frameParse(ab2hex(that.data.bufferarr) + ab2hex(res.value))                }            }        })    },

4、数据帧解析

frameParse(hex) {        console.log('hex1111111111', hex)        this.setData({            bufferarr: []        })        let myData = {            hexData: hex,            devicecode: this.data.devicecode        }        if (this.data.type == '1') {            myData.devicecode = ''        }        http.post(http.frameParse, myData).then((res, err) => {            console.log(res)            if (res.status) {                wx.showToast({                    title: '成功',                    icon: 'success',                    duration: 2000                })                //处理json数据回显渲染至页面            }        })    },

五、其他-蓝牙断开与重连

1、蓝牙手动断开

let that = this        wx.closeBLEConnection({            deviceId,            success(res) {                console.log(res)                wx.showToast({                    title: '断开成功',                    icon: 'success',                    duration: 800                })                that.setData({                    isconnect: false                })            }        })

2、重新连接

bluetooth.connetBlueDeviceId(device)

封装蓝牙连接 3-6

wx.createBLEConnection()开始

六、遇到的问题及解决

1、onBLECharacteristicValueChange监听不到响应数据

解决方法:

1、给onBLECharacteristicValueChange添加延时器;

2、给notifyBLECharacteristicValueChange添加type: 'notification';

3、给writeBLECharacteristicValue添加 writeType: 'writeNoResponse';

4、更换手机设备:Android、IOS设备;

5、查看特征值:read、notify、write、writeNoResponse;

6、分包发送:蓝牙BLE最大支持20个字节发送,因此超过20个字节需要分包发送;

7、遵循硬件文档:使用指定服务,写入、接收分别使用的特征值;

2、关键概念

字节

字节(Byte):是计算机信息技术用于计量存储容量的一种计量单位,作为一个单位来处理的一个二进制数字串。其中下发指令或处理数据时都可以应用到

  • 1B(byte,字节)= 8 bit(比特), 相当于一个字符

  • 一个字节能表示的最大的整数就是255

  • 例如: 数据为5d000001be5d理解为6个字节(6B)

MAC地址(Media Access Control Address)

蓝牙设备的物理地址,每个设备只有一个唯一值。

UUID:(Universally Unique Identifier)

通用唯一识别码,一种软件识别码,一个设备中可以有  多个UUID,一个UUID对应一个软件服务部分。

通过蓝牙的UUID来标识 蓝牙服务与通讯访问的属性,不同的蓝牙服务和属性使用的是不同的方法,所以在获取到蓝牙服务时需要保持服务一致才能通信

蓝牙的read,write,notification特征属性,都有对应的特征服务字段(同样是UUID)。

厂商可以自定义蓝牙服务以及特征字段,因此实现蓝牙通信的前提是拿到确定的服务特征值

服务(service)

有关特征值的收集,用来操作特定功能,所以一个服务里可以有多个特征值。例如,“体温计”服务包括一个温度测量值,以及测量的时间间隔。

特征值(characteristic)

在蓝牙设备之间传递的数据值,例如当前温度测量值。

3、注意事项

  • iOS 上,对特征值的 read、write、notify 操作,由于系统需要获取特征值实例,传入的 serviceId 与 characteristicId 必须由 wx.getBLEDeviceServices 与 wx.getBLEDeviceCharacteristics 中获取到后才能使用。建议统一在建立连接后先执行 wx.getBLEDeviceServices 与 wx.getBLEDeviceCharacteristics 后再进行与蓝牙设备的数据交互。

  • 考虑到蓝牙功能可以间接进行定位,安卓 6.0 及以上版本,无定位权限或定位开关未打开时,无法进行设备搜索。

  • 安卓上,部分机型获取设备服务时会多出 00001800 和 00001801 UUID 的服务,这是系统行为,注意不要使用这两个服务。

  • 建立连接和关闭连接必须要成对调用。如果未能及时关闭连接释放资源,安卓上容易导致 state 133 GATT ERROR 的异常。

  • 在与蓝牙设备传输数据时,需要注意 MTU(最大传输单元)。如果数据量超过 MTU 会导致错误,建议根据蓝牙设备协议进行分片传输。安卓设备可以调用 wx.setBLEMTU 进行 MTU 协商。在 MTU 未知的情况下,建议使用 20 字节为单位传输。

也许您对下面的内容还感兴趣: