当前位置: 首页 > news >正文

uniapp: 低功耗蓝牙(BLE)的使用

在微信小程序中实现蓝牙对接蓝牙秤的重量功能,主要依赖微信小程序提供的低功耗蓝牙(BLE)API。以下是一个清晰的步骤指南,帮助你完成从连接蓝牙秤到获取重量数据的开发流程。需要注意的是,具体实现可能因蓝牙秤的协议和硬件特性而有所不同,因此你需要参考蓝牙秤的开发文档(比如服务UUID、特征值UUID等)。


开发步骤

1. 配置小程序权限

在小程序的 app.json 文件中添加蓝牙相关权限,确保小程序有权使用蓝牙功能:

jsonJSON 格式

{"permission": {"scope.bluetooth": {"desc": "您的蓝牙权限将用于连接蓝牙秤"}}
}

2. 初始化蓝牙适配器

使用 wx.openBluetoothAdapter 初始化蓝牙模块,确保手机蓝牙已开启:

javascriptJavaScript (英语)

wx.openBluetoothAdapter({success(res) {console.log('蓝牙适配器初始化成功');// 继续后续操作},fail(res) {console.log('蓝牙适配器初始化失败,请检查蓝牙是否开启', res);}
});

3. 搜索蓝牙设备

调用 wx.startBluetoothDevicesDiscovery 开始搜索附近的蓝牙设备。通常需要根据蓝牙秤的设备名称或服务UUID进行过滤:

javascriptJavaScript (英语)

wx.startBluetoothDevicesDiscovery({success(res) {console.log('开始搜索蓝牙设备');wx.onBluetoothDeviceFound((res) => {res.devices.forEach(device => {// 根据设备名称或服务UUID筛选蓝牙秤if (device.name.includes('YourScaleName')) { // 替换为实际蓝牙秤名称console.log('发现蓝牙秤:', device);// 停止搜索wx.stopBluetoothDevicesDiscovery();// 保存设备IDconst deviceId = device.deviceId;// 连接设备connectBLE(deviceId);}});});},fail(res) {console.log('搜索设备失败', res);}
});

4. 连接蓝牙秤

使用 wx.createBLEConnection 连接指定的蓝牙秤:

javascriptJavaScript (英语)

function connectBLE(deviceId) {wx.createBLEConnection({deviceId: deviceId,success(res) {console.log('连接蓝牙秤成功');// 获取服务getBLEDeviceServices(deviceId);},fail(res) {console.log('连接失败', res);}});
}

5. 获取服务和特征值

连接成功后,使用 wx.getBLEDeviceServiceswx.getBLEDeviceCharacteristics 获取蓝牙秤的服务和特征值。特征值中通常会有一个用于读取重量数据的特征(参考设备文档):

javascriptJavaScript (英语)

function getBLEDeviceServices(deviceId) {wx.getBLEDeviceServices({deviceId: deviceId,success(res) {res.services.forEach(service => {// 假设目标服务UUID已知if (service.uuid === 'YOUR_SERVICE_UUID') { // 替换为实际服务UUIDgetBLEDeviceCharacteristics(deviceId, service.uuid);}});}});
}function getBLEDeviceCharacteristics(deviceId, serviceId) {wx.getBLEDeviceCharacteristics({deviceId: deviceId,serviceId: serviceId,success(res) {res.characteristics.forEach(characteristic => {// 找到支持通知(notify)的特征值,用于接收重量数据if (characteristic.properties.notify) {enableNotify(deviceId, serviceId, characteristic.uuid);}});}});
}

6. 启用通知并监听重量数据

使用 wx.notifyBLECharacteristicValueChange 启用特征值通知,并通过 wx.onBLECharacteristicValueChange 监听蓝牙秤发送的重量数据:

javascriptJavaScript (英语)

function enableNotify(deviceId, serviceId, characteristicId) {wx.notifyBLECharacteristicValueChange({deviceId: deviceId,serviceId: serviceId,characteristicId: characteristicId,state: true,success() {console.log('启用通知成功');// 监听特征值变化wx.onBLECharacteristicValueChange((res) => {const value = res.value; // ArrayBuffer类型数据const weight = parseWeightData(value); // 自定义解析函数console.log('当前重量:', weight);});}});
}// 解析重量数据(需根据蓝牙秤协议实现)
function parseWeightData(buffer) {const dataView = new DataView(buffer);// 示例:假设重量数据是2字节整数,单位为克const weightInGrams = dataView.getUint16(0, true); // 小端序return weightInGrams / 1000; // 转换为千克
}

7. 断开连接(可选)

使用完成后,可以通过 wx.closeBLEConnection 断开与蓝牙秤的连接:

javascriptJavaScript (英语)

wx.closeBLEConnection({deviceId: deviceId,success(res) {console.log('断开连接成功');}
});

注意事项

  1. 蓝牙秤协议:每款蓝牙秤的通信协议不同(如服务UUID、特征值UUID、数据格式),需仔细阅读设备提供的开发文档。
  2. 兼容性:iOS和Android在蓝牙实现上可能有细微差异,尤其是特征值UUID的处理(有时大小写敏感)。
  3. 数据解析:蓝牙秤返回的重量数据可能是二进制格式(如ArrayBuffer),需要根据协议转换为可读的重量值。
  4. 错误处理:确保在每个步骤中添加失败回调,提示用户检查蓝牙状态或设备连接。

流程总结

  1. 初始化蓝牙适配器。
  2. 搜索并连接目标蓝牙秤。
  3. 获取服务和特征值,找到重量数据的特征。
  4. 启用通知并监听实时重量数据。
  5. 根据协议解析数据并显示。

相关文章:

  • 《代码整洁之道》第8章 边界 - 笔记
  • JVM——垃圾收集策略
  • 【首款Armv9开源芯片“星睿“O6测评】SVE2指令集介绍与测试
  • Spring AI Alibaba - MCP连接 MySQL
  • [三分钟]web自动化测试(二):selenium自动化测试常用函数(上)
  • HarmonyOS Next~鸿蒙系统流畅性技术解析:预加载与原生架构的协同进化
  • vite.config.ts 的详细配置项说明、完整代码示例及表格总结
  • Nacos简介—4.Nacos架构和原理三
  • 英语中时间的表达
  • 数据一致性问题剖析与实践(四)——竞态条件竞争导致的一致性问题
  • C++入门小馆: STL 之queue和stack
  • JavaScript输出数据的方法
  • 解决qnn htp 后端不支持boolean 数据类型的方法。
  • 如何创建并使用极狐GitLab 部署令牌?
  • shell命令二
  • 迈锐思C1pro插件安装包【附百度网盘链接】
  • 用户行为检测技术解析:从请求头到流量模式的对抗与防御
  • DataStreamAPI实践原理——快速上手
  • 【quantity】2 Unit 结构体(unit.rs)
  • S08-电机功能块讨论
  • 主播说联播丨六部门出台新政!来华买买买,实惠多多多
  • 人民日报社论:做新时代挺膺担当的奋斗者
  • “90后”高层建筑返青春:功能调整的技术路径和运营考验
  • 明查|把太平洋垃圾污染问题甩锅中国,特朗普用的是P过的图
  • 中国人民对外友好协会代表团访问美国
  • 滁州一交通事故责任认定引质疑:民警和司法鉴定人被处罚,已中止诉讼