HarmonyOS 6.0 蓝牙BLE设备通信实战——智能手环/蓝牙秤接入全流程

发布时间：2026/10/27 5:42:37

HarmonyOS 6.0 蓝牙BLE设备通信实战——智能手环/蓝牙秤接入全流程
健康类 APP 连智能手环读心率、连蓝牙秤读体重、连血糖仪读数据——BLE低功耗蓝牙是这些 IoT 场景的通信基础。HarmonyOS NEXT 提供了完整的 BLE API扫描发现、GATT 连接、服务发现、特征值读写、通知订阅。这篇从零到一讲清楚 BLE 通信全流程。BLE 通信概览BLE 通信核心概念Peripheral外设——手环、体重秤等硬件设备广播自己的存在Central中心——手机 APP扫描并连接外设GATT——通用属性协议定义数据组织方式Service → CharacteristicService——一组相关特征的集合如心率服务0x180DCharacteristic——具体的数据项如心率测量0x2A37可读/写/通知import{ble}fromkit.ConnectivityKitimport{access}fromkit.ConnectivityKit权限配置BLE 需要蓝牙权限在 module.json5 中声明。{ requestPermissions: [ { name: ohos.permission.ACCESS_BLUETOOTH } ] }注意ACCESS_BLUETOOTH 是 user_grant 权限需要动态申请。BLE 扫描扫描是 BLE 通信的第一步——发现周围的蓝牙设备。interfaceBleDevice{id:stringname:stringrssi:numberisConnected:boolean}EntryComponentstruct BleScanDemo{StatedeviceList:BleDevice[][]StateisScanning:booleanfalseStatestatusMsg:stringbuild(){Column({space:16}){Text(BLE 扫描).fontSize(22).fontWeight(FontWeight.Bold).width(100%)Row({space:8}){Button(this.isScanning?扫描中...:开始扫描).enabled(!this.isScanning).onClick(()this.startScan())Button(停止扫描).enabled(this.isScanning).onClick(()this.stopScan())}ForEach(this.deviceList,(device:BleDevice){Row({space:12}){Column({space:2}){Text(device.name||未知设备).fontSize(15).fontWeight(FontWeight.Medium)Text(device.id).fontSize(11).fontColor(#999999)}.layoutWeight(1)Text(RSSI:${device.rssi}).fontSize(12).fontColor(device.rssi-50?#4CAF50:#FF9800)}.width(100%).padding(12).borderRadius(8).backgroundColor(#FAFAFA)},(device:BleDevice)device.id)Text(this.statusMsg).fontSize(13).fontColor(#999999)}.width(100%).padding(20)}privatestartScan():void{this.isScanningtruethis.statusMsg扫描中...需真机蓝牙权限// 真实场景ble.startBLEScan()setTimeout((){this.isScanningfalse},5000)}privatestopScan():void{this.isScanningfalse// 真实场景ble.stopBLEScan()}}真实代码ble.startBLEScan(null)ble.on(BLEDeviceFind,(result:Arrayble.ScanResult){for(leti:number0;iresult.length;i){letdevice:ble.ScanResultresult[i]// device.deviceId, device.deviceName, device.rssi}})要点startBLEScan 的参数可以传 ScanOptions 过滤特定设备按 ServiceUUID、设备名等。扫描到足够设备后及时 stopBLEScan 省电。GATT 连接扫描到目标设备后通过 GATT 连接并发现服务。// 连接设备letgattClient:ble.GattClientDeviceble.createGattClientDevice(deviceId)awaitgattClient.connect()// 发现服务letservices:Arrayble.GattServiceawaitgattClient.getServices()for(leti:number0;iservices.length;i){letservice:ble.GattServiceservices[i]letchars:Arrayble.GattCharacteristicservice.characteristics// service.serviceUuid, characteristics[].characteristicUuid}// 断开连接gattClient.disconnect()关键区别connect() 只是建立连接getServices() 才能获取设备支持的服务和特征值。必须先发现服务才能读写。特征值读写每个 Characteristic 支持三种操作读、写、通知。读取特征值// 读取心率值letcharacteristic:ble.GattCharacteristic{serviceUuid:0000180d-0000-1000-8000-00805f9b34fb,characteristicUuid:00002a37-0000-1000-8000-00805f9b34fb,characteristicValue:newArrayBuffer(0)}letresult:ble.GattCharacteristicawaitgattClient.readCharacteristicValue(characteristic)// result.characteristicValue 包含心率数据写入特征值letwriteValue:ble.GattCharacteristic{serviceUuid:0000180d-0000-1000-8000-00805f9b34fb,characteristicUuid:00002a39-0000-1000-8000-00805f9b34fb,characteristicValue:buffer// 要写入的数据}gattClient.writeCharacteristicValue(writeValue,ble.GattWriteType.WRITE_NO_RESPONSE)订阅通知心率、步数等实时数据用通知模式——设备主动推APP 被动收。gattClient.on(BLECharacteristicChange,(char:ble.GattCharacteristic){// char.characteristicValue 包含最新数据// 解析心率/步数等})// 开启通知letnotifyChar:ble.GattCharacteristic{serviceUuid:0000180d-0000-1000-8000-00805f9b34fb,characteristicUuid:00002a37-0000-1000-8000-00805f9b34fb,characteristicValue:newArrayBuffer(0)}awaitgattClient.setNotifyCharacteristicChanged(notifyChar,true)要点setNotifyCharacteristicChanged 开启通知后设备会在数据变化时主动推送不需要 APP 反复读取。BLE 通信全流程 Demo模拟完整的 BLE 通信流程——扫描→连接→发现服务→读写特征值。interfaceServiceInfo{id:stringuuid:stringcharacteristics:string[]}EntryComponentstruct BleFullDemo{StatedeviceList:BleDevice[][]StateconnectionStatus:string未连接StateserviceList:ServiceInfo[][]StatereadValue:stringStateisScanning:booleanfalsebuild(){Column({space:16}){Text(BLE 通信全流程).fontSize(22).fontWeight(FontWeight.Bold).width(100%)// 扫描区Row({space:8}){Button(this.isScanning?扫描中:扫描).onClick(()this.startScan())Button(模拟设备).onClick((){this.deviceList.push({id:AA:BB:CC:DD:EE:${(this.deviceList.length1).toString().padStart(2,0)},name:智能设备-${this.deviceList.length1},rssi:-35-this.deviceList.length*10,isConnected:false})})}// 设备列表ForEach(this.deviceList,(device:BleDevice){Row(){Text(${device.name}(${device.rssi}dBm)).fontSize(14).layoutWeight(1)if(device.isConnected){Text(已连接).fontSize(12).fontColor(#4CAF50)}else{Button(连接).fontSize(12).height(28).onClick(()this.connectDevice(device.id))}}.padding(8).borderRadius(6).backgroundColor(#FAFAFA)},(device:BleDevice)device.id)// 服务列表if(this.serviceList.length0){Text(GATT 服务:).fontSize(16).fontWeight(FontWeight.Medium).width(100%)ForEach(this.serviceList,(service:ServiceInfo){Column({space:4}){Text(服务:${service.uuid}).fontSize(13).fontColor(#1a73e8)ForEach(service.characteristics,(char:string){Row({space:8}){Text(特征:${char}).fontSize(12).layoutWeight(1)Button(读).fontSize(11).height(24).padding({left:6,right:6}).onClick((){this.readValue72 bpm})}},(char:string)char)}.padding(8).borderRadius(6).backgroundColor(#F5F5F5)},(service:ServiceInfo)service.id)}if(this.readValue){Text(读取结果:${this.readValue}).fontSize(15).fontColor(#4CAF50).padding(12).borderRadius(8).backgroundColor(#E8F5E9)}Text(this.connectionStatus).fontSize(13).fontColor(#999999)}.width(100%).padding(20)}privatestartScan():void{this.isScanningtruesetTimeout((){this.isScanningfalse},3000)}privateconnectDevice(deviceId:string):void{this.connectionStatus连接中...setTimeout((){this.connectionStatus已连接this.serviceList[{id:1,uuid:0x180D (心率),characteristics:[0x2A37 (心率测量),0x2A38 (传感器位置)]},{id:2,uuid:0x180A (设备信息),characteristics:[0x2A29 (制造商),0x2A24 (型号)]}]},1500)}}常见 BLE Service UUIDUUID名称典型特征0x180D心率服务0x2A37心率测量、0x2A38传感器位置0x181A环境感知温度、湿度、气压0x180F电池服务0x2A19电量百分比0x180A设备信息制造商、型号、固件版本0x1810血压服务收缩压、舒张压、脉率0x1818自行车速度速度、踏频踩坑清单问题原因解决startBLEScan 报错未申请蓝牙权限module.json5 声明 动态申请扫描不到设备蓝牙未开启或定位未开检查蓝牙和定位开关connect 后无服务未调用 getServicesconnect 后必须 getServicesreadCharacteristicValue 报错特征不支持读检查 properties.read 是否为 true通知收不到未 setNotifyCharacteristicChanged先 setNotify(true) 再等推送断开后重连失败未释放 GattClientdisconnect 后重新 createGattClientDeviceRSSI 值跳变大信号不稳定多次扫描取平均值写入后设备无响应写入类型不对区分 WRITE/WRITE_NO_RESPONSE连接超时设备距离远或广播间隔大靠近设备增大扫描时间多设备同时连接卡顿GATT 操作串行避免并发操作排队执行

相关新闻

ncmdumpGUI：解锁网易云音乐NCM加密文件的终极解决方案

ncmdumpGUI：解锁网易云音乐NCM加密文件的终极解决方案

ncmdumpGUI：解锁网易云音乐NCM加密文件的终极解决方案 【免费下载链接】ncmdumpGUI C#版本网易云音乐ncm文件格式转换，Windows图形界面版本 项目地址: https://gitcode.com/gh_mirrors/nc/ncmdumpGUI 你是否曾遇到过这样的情况：从网易…

2026/10/22 1:13:19 阅读更多 →
C语言：自定义类型：结构体

C语言：自定义类型：结构体

文章目录前言1.什么是结构体？2.结构体类型的声明2.1结构的声明2.2 结构体变量的创建和初始化2.3 结构的特殊声明2.4 结构体的自引用3.结构体内存对齐3.1 对齐规则3.2 为什么需要内存对齐？3.3 修改默认对齐数3.4 结构体传参4.结构体实现位段4.1 位段的定义…

2026/10/25 14:04:24 阅读更多 →
VMware Workstation Pro 17 保姆级安装与使用教程

VMware Workstation Pro 17 保姆级安装与使用教程

在软件开发、系统测试或学习新操作系统时，你是否曾因频繁重装系统、担心软件冲突或需要隔离环境而烦恼？虚拟机技术正是解决这些痛点的利器。VMware Workstation Pro 作为行业标杆的桌面虚拟化软件，允许你在单一物理机上同时运行多个独立的操作…

2026/10/27 0:51:33 阅读更多 →

最新新闻

Electron桌面应用开发实战：从环境搭建到打包发布全流程

Electron桌面应用开发实战：从环境搭建到打包发布全流程

做前端这些年，我大部分时间都在跟浏览器标签页打交道，直到第一次把桌面应用跑起来，才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词，最开始是在某段时间频繁出现在同事的讨论里，一个用HTML…

2026/10/27 17:33:32 阅读更多 →
滑盖智能锁T109深度解析：结构原理、安装调试与故障排查

滑盖智能锁T109深度解析：结构原理、安装调试与故障排查

简介：亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档，主要面向智能锁安装人员、终端用户及售后维护者，帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件，大小4.37MB，内容结构清晰&#xff…

2026/10/27 4:06:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模：高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模：高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统，整车要求空载跑到8m/s，电机转速已经拉到额定点，驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令，转速纹丝不动，三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/10/27 7:21:53 阅读更多 →
C++核心知识点：从内存管理到STL的实战指南

C++核心知识点：从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年，用它写过嵌入式驱动、做过游戏服务端，也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词，我其实挺感慨的——这门语言的难点从来不是语法多，而是知识点之间的耦合太深…

2026/10/27 18:20:50 阅读更多 →
T109滑盖智能锁怎么装？安装调试与故障排查全攻略

T109滑盖智能锁怎么装？安装调试与故障排查全攻略

简介：亚太天能T109滑盖智能锁产品说明书以PDF格式发布，适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开，先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能，再给出完整安装步骤&…

2026/10/27 6:20:47 阅读更多 →
LLM知识降熵：从信息垄断到理解权下放

LLM知识降熵：从信息垄断到理解权下放

你有没有过这种经历：翻开源码注释、论文摘要或者一份专业报告，每个字都认识，连在一起却像天书。想找人聊聊，身边要么没人懂，要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型，几秒钟之后&a…

2026/10/27 4:06:50 阅读更多 →

日新闻

周新闻

月新闻

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/27 13:55:19 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/27 7:21:50 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/27 19:19:37 阅读更多 →