1. 低功耗蓝牙开发入门指南第一次接触低功耗蓝牙开发时我被各种专业术语绕得头晕眼花。BLEBluetooth Low Energy和传统蓝牙完全不同它专为低功耗设备设计比如智能手环、体温计这些小玩意儿。H5Plus方案最大的优势就是跨平台一套代码能跑在安卓和iOS上省去了不少适配的麻烦。开发前得先搞明白几个核心概念GATT协议规定了设备间通信的规则每个设备包含若干服务Service每个服务又包含多个特征值Characteristic。这就像去银行办事先找到对应窗口服务再选择具体业务特征值。实际开发中最常用的UUID有通用属性服务0x1800设备信息服务0x180A电池服务0x180F建议先在电脑上装个nRF Connect这类调试工具能直观看到设备的所有服务和特征值。我刚开始开发时没用这些工具对着文档硬啃白白浪费了两周时间。2. 开发环境搭建实战要玩转H5Plus的蓝牙功能得先准备好开发环境。推荐使用HBuilderX最新版创建移动App项目时记得勾选蓝牙模块权限。安卓设备需要6.0以上系统iOS则要求10.0以上这点很多新手容易忽略。第一次运行时可能会遇到白屏问题通常是权限没配置好。需要在manifest.json里添加这些配置permissions: { Bluetooth: { description: 低功耗蓝牙功能 }, BluetoothAdmin: { description: 蓝牙设备管理 } }实测发现不同手机厂商的蓝牙实现有差异建议准备至少三台测试机小米、华为和iPhone。我曾在华为P40上遇到搜索不到设备的情况最后发现是EMUI系统的省电模式限制了蓝牙扫描。3. 设备扫描与连接技巧调用plus.bluetooth.openBluetoothAdapter()初始化适配器后真正的挑战才开始。startBluetoothDevicesDiscovery这个API有个隐藏坑点安卓和iOS的扫描策略完全不同。安卓设备默认会重复上报已发现的设备而iOS只会报告新设备。这里分享我的优化扫描代码let filterDevices [] plus.bluetooth.onBluetoothDeviceFound(device { // 根据设备名称过滤 if(!device.name || !device.name.includes(MyDevice)) return // 去重处理 const exists filterDevices.some(item item.deviceId device.deviceId ) if(!exists) { filterDevices.push(device) console.log(发现目标设备:, device) } }) // 设置扫描超时 setTimeout(() { plus.bluetooth.stopBluetoothDevicesDiscovery() }, 15000)连接设备时有个玄学问题立即连接大概率失败。后来发现添加200ms延迟就能解决这应该是蓝牙协议栈的初始化需要时间。我的重连方案是这样的function connectWithRetry(deviceId, retryCount 0) { if(retryCount 3) { return Promise.reject(超过最大重试次数) } return new Promise((resolve, reject) { setTimeout(() { plus.bluetooth.createBLEConnection({ deviceId, success: resolve, fail: () { connectWithRetry(deviceId, retryCount 1) .then(resolve) .catch(reject) } }) }, 200) }) }4. 服务与特征值操作详解获取到设备服务列表后常见的问题是找不到目标服务。这时候要检查两点一是确保设备已连接成功二是确认服务UUID是否正确。有些厂商会使用自定义UUID需要他们提供技术文档。特征值操作是蓝牙开发的核心主要涉及三种操作读取数据characteristic.read true写入数据characteristic.write true订阅通知characteristic.notify true这里有个关键经验写入数据前一定要先订阅通知。我曾在智能锁项目上栽过跟头因为没订阅通知设备返回的解锁状态完全收不到。正确的操作顺序应该是// 1. 开启通知 plus.bluetooth.notifyBLECharacteristicValueChange({ deviceId, serviceId, characteristicId, state: true, success: () { // 2. 写入数据 writeDataToDevice() } }) // 3. 在全局监听回调中处理设备响应 plus.bluetooth.onBLECharacteristicValueChange(res { console.log(收到设备数据:, buf2hex(res.value)) })数据转换是另一个重灾区。蓝牙通信使用ArrayBuffer格式和日常的字符串处理完全不同。这里分享我封装的转换工具// 字符串转ArrayBuffer function str2ab(str) { const buf new ArrayBuffer(str.length) const view new Uint8Array(buf) for (let i 0; i str.length; i) { view[i] str.charCodeAt(i) } return buf } // ArrayBuffer转16进制字符串 function buf2hex(buffer) { return Array.from(new Uint8Array(buffer)) .map(b b.toString(16).padStart(2, 0)) .join() } // 16进制字符串转ArrayBuffer function hex2ab(hex) { const bytes [] for (let i 0; i hex.length; i 2) { bytes.push(parseInt(hex.substr(i, 2), 16)) } return new Uint8Array(bytes).buffer }5. 大数据分包传输方案BLE协议单次传输限制在20字节内超过就要分包发送。但分包不是简单切割就行要考虑以下问题包序标识让设备知道是第几包超时重传某包丢失时要能重发流量控制避免发送过快导致丢包这是我优化过的分包发送方案function sendLargeData(deviceId, serviceId, charId, data) { const chunkSize 18 // 留2字节给包序 const chunks [] const total Math.ceil(data.length / chunkSize) // 添加包头 for (let i 0; i total; i) { const head new Uint8Array(2) head[0] i // 当前包序 head[1] total // 总包数 const chunk data.slice( i * chunkSize, (i 1) * chunkSize ) const merged new Uint8Array(head.length chunk.length) merged.set(head) merged.set(chunk, head.length) chunks.push(merged.buffer) } // 控制发送间隔 let counter 0 const interval setInterval(() { if (counter chunks.length) { clearInterval(interval) return } plus.bluetooth.writeBLECharacteristicValue({ deviceId, serviceId, characteristicId: charId, value: chunks[counter], success: () { console.log(发送成功 ${counter1}/${total}) counter }, fail: (err) { console.error(发送失败:, err) clearInterval(interval) } }) }, 50) // 50ms间隔 }接收端处理也要对应改造let receivedChunks [] let totalChunks 0 plus.bluetooth.onBLECharacteristicValueChange(res { const data new Uint8Array(res.value) const seq data[0] const total data[1] if (seq 0) { // 第一包初始化 receivedChunks new Array(total) totalChunks total } // 存储数据部分去掉前2字节包头 receivedChunks[seq] data.slice(2) // 检查是否接收完成 if (receivedChunks.filter(Boolean).length totalChunks) { const merged receivedChunks.reduce((acc, chunk) { const tmp new Uint8Array(acc.length chunk.length) tmp.set(acc) tmp.set(chunk, acc.length) return tmp }, new Uint8Array(0)) console.log(完整数据:, buf2hex(merged.buffer)) } })6. 连接稳定性优化实战蓝牙连接不稳定是开发者最头疼的问题。经过多个项目积累我总结出这些经验重连策略优化指数退避重试第一次立即重连第二次延迟1秒第三次延迟4秒心跳检测机制定期发送ping包检测连接状态异常断开处理监听onBLEConnectionStateChange事件完整示例let reconnectAttempts 0 let heartbeatTimer null plus.bluetooth.onBLEConnectionStateChange(res { if (!res.connected) { scheduleReconnect(res.deviceId) } else { // 连接成功启动心跳 startHeartbeat(res.deviceId, serviceId, charId) } }) function scheduleReconnect(deviceId) { const delay Math.min(30, Math.pow(2, reconnectAttempts)) * 1000 console.log(将在${delay/1000}秒后重连...) reconnectAttempts setTimeout(() { connectWithRetry(deviceId) }, delay) } function startHeartbeat(deviceId, serviceId, charId) { clearInterval(heartbeatTimer) heartbeatTimer setInterval(() { plus.bluetooth.writeBLECharacteristicValue({ deviceId, serviceId, characteristicId: charId, value: str2ab(PING), success: () { console.log(心跳发送成功) reconnectAttempts 0 }, fail: () { console.log(心跳发送失败) clearInterval(heartbeatTimer) } }) }, 30000) // 30秒一次 }功耗优化技巧扫描间隔设置不宜过频建议5-10秒及时释放资源页面退出时关闭蓝牙适配器后台运行策略iOS需要特殊配置才能后台维持连接7. 典型问题排查指南开发过程中遇到的90%问题都集中在以下几个方面设备搜索不到检查设备是否处于可发现模式确认设备没有被其他应用占用尝试重启手机蓝牙连接频繁断开检查设备电量是否充足避免手机和蓝牙设备之间有金属遮挡降低通信频率测试是否改善数据读写异常确认特征值属性支持当前操作检查数据格式是否符合设备要求尝试减小数据包大小测试这是我常用的调试检查清单蓝牙适配器是否初始化成功设备是否在蓝牙范围内最好在3米内目标服务UUID是否正确特征值属性是否支持当前操作数据格式是否符合设备要求是否已经订阅特征值通知遇到疑难问题时建议用蓝牙嗅探工具抓包分析。Windows平台可以用WireShark蓝牙适配器Mac平台可以用PacketLogger。不过要注意有些加密通信无法直接解析。