uniapp 与蓝牙设备收发指令详细步骤(完整项目版)

2024-07-08 19:26| 来源: 网络整理| 查看: 265

阅读前须知：

1、若已知蓝牙设备的 deviceId、serviceId、以及读写特征值，可以直接从第7点开始阅读 2、文档中各函数的详细属性、回调函数等介绍内容，可以查看官网文档：uniapp 低功耗蓝牙连接 3、与蓝牙设备之间收发数据格式必须为 ArrayBuffer 4、本文中与蓝牙设备收发数据时，数据包的长度为20 字节，不够 20 字节的补 0

1、初始化蓝牙模块 uni.openBluetoothAdapter({ success(res) { console.log('初始化蓝牙成功') console.log(res) }, fail(err) { console.log('初始化蓝牙失败') console.error(err) } }) 2、搜索附近可连接的蓝牙设备

uni.startBluetoothDevicesDiscovery()比较耗费系统资源，建议搜索完成后调用stopBluetoothDevicesDiscovery()结束搜索。

uni.startBluetoothDevicesDiscovery({ allowDuplicatesKey: false, interval: 0, success: (res) => { console.log("执行搜索成功的回调") }, fail: (error) => { console.log(error) } })

若需要过滤搜索出来的蓝牙设备，可以设置services属性进行过滤

在这里插入图片描述

3、搜索附近可连接的蓝牙设备

uni.getBluetoothDevices()获取在蓝牙模块生效期间所有已发现的蓝牙设备。包括已经和本机处于连接状态的设备

uni.getBluetoothDevices({ success: function(res) { console.log(res) }, fail: function() { console.log("获取蓝牙设备列表失败") } })

到这一步，已经能拿到附近所有的蓝牙设备列表，下面开始进行连接。

4、连接低功耗蓝牙设备

前提条件：

蓝牙设备支持低功耗协议（BLE）拿到设备的deviceId值 uni.createBLEConnection({ deviceId: this.deviceId, // 在第 3 步可以拿到蓝牙的 deviceId 的值 success: (res) => { console.log("连接成功", res) // 在这里可以执行获取蓝牙设备的所有服务，若获取失败可以使用 setTimeout }, fail: (error) => { console.log("连接失败", error) } }) 5、获取蓝牙设备的所有服务 uni.getBLEDeviceServices({ deviceId: this.deviceId, // 在第 3 步可以拿到蓝牙的 deviceId 的值 success: (res) => { console.log('成功获取蓝牙设备的所有服务', res) // 这里可以拿到蓝牙设备的 serviceId } }) 6、获取蓝牙设备某个服务中所有特征值（characteristic） uni.getBLEDeviceCharacteristics({ deviceId: this.deviceId, // 在第 3 步可以拿到蓝牙的 deviceId 的值 serviceId: this.serviceId, // 在第 5 步可以拿到蓝牙的 serviceId 的值 success: (res) => { console.log('获取 characteristic 成功', res) // 在这里可以获取到这个服务的所有特征值，需要确定哪些特征值是此次使用的 // 一般这里可以拿到两个特征值：写characteristic、读characteristic // 接下来这里可以根据拿到的“读characteristic”开启 notify }, fail: (res) => { console.log('获取 characteristic 失败', res) } }) 7、启动 notify 功能监听蓝牙设备回传信息

注意：必须设备的特征值支持 notify 或者 indicate 才可以成功调用

uni.notifyBLECharacteristicValueChange({ state: true, deviceId: this.deviceId, // 在第 3 步可以拿到蓝牙的 deviceId 的值 serviceId: this.serviceId, // 在第 5 步可以拿到蓝牙的 serviceId 的值 characteristicId: this.readCharacteristic, // 在第 6 步可以拿到蓝牙的 characteristic 的值，这里使用的是 “读characteristic” success(res) { console.log("开启 notify 功能成功...") // 必须先启用 notifyBLECharacteristicValueChange 接口才能接收到设备推送 uni.onBLECharacteristicValueChange(res => { let resHex = ab2hex(res.value) // 将蓝牙设备回传的内容进行解析 console.log("接收到回传内容：", resHex) // 若需要，可参考第 9 点解析响应包的源码 // 蓝牙设备会分多次回传数据，并且都可以在这里监听到 // 这里可以执行一个处理所有回传结果的函数 }) }, fail(err) { console.log("监听失败，发生错误", err) } }) // ArrayBuffer 转 16 进制字符串示例 function ab2hex(buffer) { const hexArr = Array.prototype.map.call( new Uint8Array(buffer), function (bit) { return ('00' + bit.toString(16)).slice(-2) } ) return hexArr.join('') }

到这里，已经完成了与低功耗蓝牙设备连接、蓝牙设备回传数据的监听。

8、向蓝牙设备发送指令

假设，存在一个获取蓝牙设备电量的指令如下：

向蓝牙设备发送数据格式：

起始码数据类型数据0xSA0x010x00,0x00,…,0x00

蓝牙设备回传数据格式：

起始码数据类型结果电量空数据0xRA0x010x010x140x00,0x00,…,0x00 let buffer = generate_command(0xSA, 0x01) uni.writeBLECharacteristicValue({ deviceId: this.deviceId, // 在第 3 步可以拿到蓝牙的 deviceId 的值 serviceId: this.serviceId, // 在第 5 步可以拿到蓝牙的 serviceId 的值 characteristicId: this.writeCharacteristicId, // 在第 6 步可以拿到蓝牙的 characteristic 的值，这里使用的是 “写characteristicId” value: buffer, // buffer 的格式为 ArrayBuffer success(res) { console.log('指令下发成功', res) }, fail(err) { console.log('指令发送失败', err) } }) /** * 生成 ArrayBuffer 格式的数据，可以直接用于给蓝牙设备发送数据 * @param {Object} startCode 起始码 * @param {Object} dataType 数据类型 * @param {Object} sentData 发送给蓝牙的数据数组，例如：[0x12,0x01] */ function generate_command(startCode, dataType, sentData) { let buffer = new ArrayBuffer(20) let dataView = new DataView(buffer) dataView.setUint8(0, startCode) dataView.setUint8(1, dataType) let _beforeIndex = 2 if(sentData) { for (var k = 0; k const dataList = responseData.match(/.{1,2}/g) const [resCode, resType, resResult] = dataList.splice(0, 3) // resCode：响应包起始码； // resType：响应包数据类型 // resResult：响应包结果 // dataList：其他响应数据 + 空数据，Array 格式数据 return [resCode, resType, String(resResult), dataList] } 10、附加：将上一步的 Array 解析成 number function array16_to_number(arrayValue) { const newArray = arrayValue.filter(item => String(item) !== '00' || String(item) !== '0') const _number16 = newArray.map(hex => parseInt(hex, 16).toString(16)).join('') return parseInt(`0x${_number16}`) }

如第 8 点，指令返回的电量结果为0x14，经过转换的得到值为20

在这里插入图片描述

【本文地址】

公司简介

联系我们