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

发布时间：2026/8/10 11:46:40

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/8/10 11:46:40 阅读更多 →
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/8/10 11:46:40 阅读更多 →
VMware Workstation Pro 17 保姆级安装与使用教程

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

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

2026/8/10 11:45:40 阅读更多 →

最新新闻

GSEApy vs GSEA桌面版：哪款基因集富集分析工具更适合你的研究？

GSEApy vs GSEA桌面版：哪款基因集富集分析工具更适合你的研究？

GSEApy vs GSEA桌面版：哪款基因集富集分析工具更适合你的研究？ 【免费下载链接】GSEApy Gene Set Enrichment Analysis in Python 项目地址: https://gitcode.com/gh_mirrors/gs/GSEApy GSEApy是一款基于Python的基因集富集分析工具，能…

2026/8/10 17:14:12 阅读更多 →
5分钟上手AzCopy v10：从安装到云存储数据迁移完全指南

5分钟上手AzCopy v10：从安装到云存储数据迁移完全指南

5分钟上手AzCopy v10：从安装到云存储数据迁移完全指南 【免费下载链接】azure-storage-azcopy The new Azure Storage data transfer utility - AzCopy v10 项目地址: https://gitcode.com/gh_mirrors/az/azure-storage-azcopy AzCopy v10是Azure Storage官方…

2026/8/10 17:14:12 阅读更多 →
Android RecyclerView布局切换技巧：Sample项目中的LinearLayout与GridLayout无缝转换

Android RecyclerView布局切换技巧：Sample项目中的LinearLayout与GridLayout无缝转换

Android RecyclerView布局切换技巧：Sample项目中的LinearLayout与GridLayout无缝转换 【免费下载链接】android-RecyclerView Migrated: 项目地址: https://gitcode.com/gh_mirrors/an/android-RecyclerView Android RecyclerView是实现高效列表展示的核心组…

2026/8/10 17:14:12 阅读更多 →
拼多多免费流量和付费推广怎么做

拼多多免费流量和付费推广怎么做

做拼多多的商家都懂，店铺运营的核心命脉就是流量转化。很多新手商家踩坑无数：死守免费流量没曝光、不开付费就没单，开通直通车、场景推广又烧钱没投产，新店破零难、老店权重停滞、新品起量缓慢，这几乎是所有拼多多运营…

2026/8/10 17:14:12 阅读更多 →
淘宝新店有效推广方法，新手零成本起店实战攻略

淘宝新店有效推广方法，新手零成本起店实战攻略

淘宝新店最大的运营难题不是不会上架产品，而是零流量、零销量、权重低、付费推广成本高。新店无基础权重，自然搜索排名靠后，直通车、超级推荐投产比极低，很多新手商家卡在起店阶段直接放弃。本文结合实战经验，分享淘宝…

2026/8/10 17:14:12 阅读更多 →
HTTP.jl性能优化指南：提升Julia HTTP应用响应速度的5个技巧

HTTP.jl性能优化指南：提升Julia HTTP应用响应速度的5个技巧

HTTP.jl性能优化指南：提升Julia HTTP应用响应速度的5个技巧 【免费下载链接】HTTP.jl HTTP for Julia 项目地址: https://gitcode.com/gh_mirrors/ht/HTTP.jl HTTP.jl是Julia语言中功能强大的HTTP客户端和服务器库，为Julia开发者提供了高效处理HT…

2026/8/10 17:13:11 阅读更多 →

日新闻

GraphQL-CSS API全解析：useGqlCSS、GqlCSS组件与getStyles实用指南

GraphQL-CSS API全解析：useGqlCSS、GqlCSS组件与getStyles实用指南

GraphQL-CSS API全解析：useGqlCSS、GqlCSS组件与getStyles实用指南 【免费下载链接】graphql-css A blazing fast CSS-in-GQL™ library. 项目地址: https://gitcode.com/gh_mirrors/gr/graphql-css GraphQL-CSS是一个基于GraphQL的CSS-in-GQL™库&#xff0…

2026/8/10 0:00:02 阅读更多 →
告别语言障碍：KISS Translator 双语翻译插件终极指南

告别语言障碍：KISS Translator 双语翻译插件终极指南

告别语言障碍：KISS Translator 双语翻译插件终极指南 【免费下载链接】kiss-translator A simple, open source bilingual translation extension & Greasemonkey script (一个简约、开源的 双语对照翻译扩展 & 油猴脚本) 项目地址: https://gitcode.com/…

2026/8/10 0:00:02 阅读更多 →
BepInEx配置管理器：游戏插件配置的终极可视化解决方案

BepInEx配置管理器：游戏插件配置的终极可视化解决方案

BepInEx配置管理器：游戏插件配置的终极可视化解决方案 【免费下载链接】BepInEx.ConfigurationManager Plugin configuration manager for BepInEx 项目地址: https://gitcode.com/gh_mirrors/be/BepInEx.ConfigurationManager 你是否曾经因为游戏插件的复杂…

2026/8/10 0:00:02 阅读更多 →

周新闻

5分钟告别提取码焦虑：baidupankey如何智能破解百度网盘资源锁

5分钟告别提取码焦虑：baidupankey如何智能破解百度网盘资源锁

5分钟告别提取码焦虑：baidupankey如何智能破解百度网盘资源锁 【免费下载链接】baidupankey 在线查询网盘提取码（维护中 rm repo） 项目地址: https://gitcode.com/gh_mirrors/ba/baidupankey 你是否曾经在深夜寻找一份重要资料&#x…

2026/8/10 1:05:29 阅读更多 →
如何快速生成中国车牌图片：Python开源工具完整指南

如何快速生成中国车牌图片：Python开源工具完整指南

如何快速生成中国车牌图片：Python开源工具完整指南 【免费下载链接】chinese_license_plate_generator 中国车牌生成器 项目地址: https://gitcode.com/gh_mirrors/ch/chinese_license_plate_generator 中国车牌生成器是一个基于Python的开源项目&#xff0c…

2026/8/10 1:05:29 阅读更多 →
收藏！小白程序员轻松入门大模型，从Harness工程开始实践

收藏！小白程序员轻松入门大模型，从Harness工程开始实践

文章强调学习大模型不应只关注模型本身，而应重视模型外的系统搭建，即Harness。提出AgentModelHarness的实用公式，详细介绍Harness的四个层次：持久化层、执行层、控制层和观察与验证层。文章还探讨了上下文工程、工具设计、AGENTS.…

2026/8/10 1:05:29 阅读更多 →

月新闻

免费解锁百度网盘SVIP加速：macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速：macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速：macOS用户必备的下载提速终极指南 【免费下载链接】BaiduNetdiskPlugin-macOS For macOS.百度网盘 破解SVIP、下载速度限制~ 项目地址: https://gitcode.com/gh_mirrors/ba/BaiduNetdiskPlugin-macOS 还在为百度网盘macOS版的龟速下…

2026/8/10 17:07:33 阅读更多 →
终极ncmdump指南：3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南：3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南：3分钟实现网易云NCM音乐解密与格式转换 【免费下载链接】ncmdump 项目地址: https://gitcode.com/gh_mirrors/ncmd/ncmdump 还在为网易云音乐下载的NCM格式文件无法在其他播放器播放而烦恼吗？ncmdump解密工具帮你轻松解决这个困…

2026/8/10 1:05:29 阅读更多 →
HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片：为英语学习 App 打造桌面级学习助手

HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片：为英语学习 App 打造桌面级学习助手

AgentCard 智能体卡片：为英语学习 App 打造桌面级学习助手适用平台：HarmonyOS 7.0 (API 26 Beta)一、引言 HarmonyOS 7.0（API 26 Beta）新增了 AgentCard 智能体卡片能力，这是继 HMAF（鸿蒙智能体框架&#x…

2026/8/10 17:07:33 阅读更多 →