本文详解在 kotlin 移动开发中，不依赖厂商私有 sdk，而是基于 bluetooth low energy（ble）标准协议，通用化读取 mi band、huawei watch 等主流健身追踪器的心率、步数等健康数据的完整技术路径。

本文详解在 kotlin 移动开发中，不依赖厂商私有 sdk，而是基于 bluetooth low energy（ble）标准协议，通用化读取 mi band、huawei watch 等主流健身追踪器的心率、步数等健康数据的完整技术路径。

在 Android 平台使用 Kotlin 开发健康类应用时，若希望兼容多品牌健身追踪器（如 Mi Band、Huawei Watch、Amazfit 等），最可靠且通用的技术方案并非调用各厂商封闭 API，而是直接对接设备暴露的 BLE 服务与特征（Characteristic）。该方式遵循蓝牙 SIG 官方规范，具备跨平台、免授权、可扩展等优势，但需开发者理解 BLE 通信模型并正确解析二进制数据。

? 核心流程：发现 → 连接 → 发现服务 → 订阅特征 → 解析数据

1. 建立 BLE 连接
   使用 BluetoothLeScanner 扫描设备，通过 BluetoothDevice.connectGatt() 建立 GATT 连接。推荐使用 androidx.bluetooth:bluetooth-adapter 或成熟封装库（如 RxAndroidBle 或 Nordic Semiconductor’s nRF Connect SDK）简化状态管理与线程调度。

2. 发现标准服务（Standard Services）
   连接成功后，调用 gatt.discoverServices() 获取设备支持的服务列表。关键服务 UUID 需对照蓝牙官方分配表（Assigned Numbers PDF）识别：

   • 心率服务（Heart Rate Service, HRS）：0000180D-0000-1000-8000-00805F9B34FB（即 0x180D）
   • 电池服务（Battery Service）：0000180F-0000-1000-8000-00805F9B34FB
   • 设备信息服务（Device Information Service）：0000180A-0000-1000-8000-00805F9B34FB

3. 定位目标特征（Characteristic）并启用通知
   以心率为例，HRS 中核心特征为 Heart Rate Measurement，UUID 为 00002A37-0000-1000-8000-00805F9B34FB（0x2A37）。注意：该特征仅支持 Notify（通知）模式，不可直接 read()。需执行以下操作：

   val hrChar = hrsService.getCharacteristic(UUID.fromString("00002A37-0000-1000-8000-00805F9B34FB"))
   gatt.setCharacteristicNotification(hrChar, true)
   
   // 启用 Client Characteristic Configuration Descriptor (CCCD)
   val cccd = hrChar.getDescriptor(UUID.fromString("00002902-0000-1000-8000-00805F9B34FB"))
   cccd.value = BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE
   gatt.writeDescriptor(cccd)

4. 解析原始字节流（关键！）
   收到的 onCharacteristicChanged() 回调中，value 是 ByteArray。心率数据按 HRS 规范 编码：首字节为标志位（Flags），后续为心率值（单位：bpm）、可选能量消耗、RR 间期等。典型解析逻辑如下：

   override fun onCharacteristicChanged(
       gatt: BluetoothGatt?,
       characteristic: BluetoothGattCharacteristic,
       value: ByteArray
   ) {
       if (characteristic.uuid == UUID.fromString("00002A37-0000-1000-8000-00805F9B34FB")) {
           val flags = value[0].toInt()
           var offset = 1
           val is16BitHR = (flags and 0x01) != 0 // 检查心率是否为16位
           val heartRate = if (is16BitHR) {
               ((value[offset + 1].toInt() and 0xFF) shl 8) or (value[offset].toInt() and 0xFF)
           } else {
               value[offset].toInt() and 0xFF
           }
           Log.d("BLE", "Heart Rate: $heartRate bpm")
       }
   }

⚠️ 重要注意事项与实践建议

• 厂商自定义服务不可避免：如 Mi Band 步数、睡眠等数据通常不走标准 PAMS（0x181C）服务，而使用私有服务（如 0xFEE0）及特征（如 0x0007）。此时需逆向分析或参考开源项目（如 miband-android）。
• 权限与兼容性：Android 12+ 要求 BLUETOOTH_SCAN、BLUETOOTH_CONNECT 动态权限；部分国产 ROM（如 MIUI、EMUI）存在后台 BLE 限制，需引导用户关闭省电优化。
• 连接稳定性：务必实现重连机制、GATT 状态监听（onConnectionStateChange）、服务发现失败重试，并避免在主线程执行阻塞操作。
• 调试利器：使用 nRF Connect App 扫描设备服务结构，验证 UUID 与数据格式，大幅降低开发门槛。

综上，虽然不存在“一键接入所有手环”的万能 API，但基于 BLE 标准协议构建的通用采集层，配合对主流设备私有协议的渐进式适配（通过 GitHub 开源项目持续迭代），是实现跨品牌健康数据集成最稳健、可持续的技术路径。