国内穿戴生态:官方接入路线与可读边界
核对日期:2026-10-01。本文核对华为 Health Kit、当前小米运动健康数据平台、Zepp/Amazfit 开发能力,以及 OtterLife FAQ 所述实际产品路线。本文仅据官方开发者文档、官方帮助/产品文档整理;没有登录开发者后台、申请权限、连接设备或实测数据。文中“可获得”指文档公开说明接口能返回的字段/类型,不表示任何普通新应用已获正式权限,也不证明某一设备一定产生该字段。
路线速览
| # | 路线 | 普通开发者可申请/可做 | 文档列出的可得数据 | 平台差异、延迟与边界 |
|---|---|---|---|---|
| 1 | 华为 Health Service Kit:Android 设备端 SDK | 可在华为开发者平台申请 Health Service Kit 和所需 scopes;开发完成后须提交审核取得正式 scopes。初始测试 scopes 限 100 用户;审核约 15 个工作日,批准后约 24 小时生效。用户再逐项授权。 | 读写数据样本、读取当日/多日统计、最新采样点;官方示例含连续步数增量、身高;运动记录可含开始/结束时间、时长、距离、卡路里、配速、速度、平均心率、步数、步频及数据来源(设备/华为健康或手动)。运动详情字段需对应 scope。 | 端侧 SDK 是 Android 路线;调用条件包括前台运行/屏幕亮起等,后台被动拉取不应默认可行。云端同步与用户健康 App 开关、授权有关。运动记录查询时效官方个别数据类型写“分钟级”,以具体数据类型页为准。Android/HMS Core/华为健康 App 版本也会影响空结果。 |
| 2 | 华为 Health Service Kit:云端 REST;iOS 可用性边界 | 官方 Health Kit 页面列支持 iOS;官方 REST 云端接口通过 Huawei ID/OAuth scopes 与用户授权访问。开发者需先申请 Health Service Kit 权限并完成应用审核;接口还依赖 Huawei Health 用户在 App 中打开 Health Kit 分享和云同步。 | 云端数据目录包含日常活动/步数、心率、睡眠、运动记录及其统计/采样详情等;运动记录可读取运动类型、时间范围、汇总及关联采样数据,另有位置 scope。字段与数据源支持情况应查各具体类型的 Data Openness 表。 | iOS 不能据“Health Kit 支持 iOS”推断可直接调用 Android 设备端 SDK。可确认的共同路线是 iOS App/用户通过 Health Kit 授权使用云 REST;官方 FAQ 指出无数据时需检查 iPhone 端华为运动健康版本、第三方服务链接、Health Kit 开关及手动云同步。具体 iOS 端 SDK/组件和各类型覆盖须按当前 SDK 文档逐项确认。 |
| 3 | 小米运动健康(Mi Fitness)→ 小米运动健康数据平台云 API | 开发者需在小米开放平台申请账号服务、开通小米运动健康服务并获批所需权限;小米账号 OAuth 取得 Access Token,用户授权后服务端以 Bearer token 调 API。支持撤销授权;可配置数据更新订阅,收到变化通知后再拉取。 | 官方权限目录包括步数、卡路里、中高强度活动、有效站立、活力指标、运动记录概要/详情/位置、心率、血氧、睡眠、体重、VO₂ max、压力、设备和个人信息;具体授权按 scope。例子/类型名包括 com.xiaomi.steps.delta、com.xiaomi.steps.total、com.xiaomi.heart_rate.delta、com.xiaomi.spo2.instantaneous、com.xiaomi.sleep.health。运动记录可有类型、起止时间、时区、设备信息、时长/配速/统计摘要、修改时间。 |
这是账号授权后的服务器云 API,不是任意 Android/iOS App 直接读手环 BLE;官方文档对调用方的移动端差异未给出统一承诺,建议将用户授权/登录界面和后端 API 分开评估。订阅说明为“数据变化时实时通知”,是通知触发后拉数据,不构成用户佩戴到浮光可见的端到端时延 SLA。采样查询窗口最多 30 天,多日统计/活力指标最多 7 天;分页、用户授权、同步写入状态都会影响结果。 |
| 4 | 小米手环 → Mi Fitness / Zepp Life → 第三方 App(OtterLife 公布路线) | OtterLife FAQ 自述:Android 手机 App 可选“小米运动健康”或 Zepp Life 数据来源;其支持范围限小米手环 4–7,不含 7 Pro;不支持对应的手环/手表端 App。iOS 手机则只读其他设备写入 Apple Health 的有限字段,不支持把这些设备配套表 App 安装到 OtterLife 手表端。 | FAQ 明确列“运动记录”支持差异:iOS 仅 Apple Watch 记录;华为只支持华为手表/手环端运动;小米和手机来源不支持运动记录。该 FAQ 未逐项列出小米路线能同步到 OtterLife 的字段全集,故不可把小米开放平台全量字段写成 OtterLife 实际字段。 | FAQ 说明安卓华为链路从华为云拉取,设备未云同步会延迟;这不是华为运动健康本地读取。FAQ 没有量化小米/Zepp Life 的拉取频率或延迟;也没有说明 OtterLife 两种小米来源具体实现是 Mi Fitness 开放云 API、系统仓库还是合作接口,必须保持未知。FAQ 还称其不把用户健康数据存到自家云端、Android/iOS 数据不互通。 |
| 5 | Amazfit/Zepp OS:第三方手表端 App/扩展 | 普通开发者可用 Zepp OS 文档、工具、模拟器开发适配 Zepp OS 的手表 App;官方提供传感器 API 能力示例,也有 BLE API,可连接外设。此能力是开发并运行手表端应用,不等于获准读取 Zepp 手机 App/Zepp 云中的用户历史。 | 可按目标 Zepp OS/API level 使用设备端传感器与运动扩展能力,例如心率监测、地理位置、加速度计;具体字段、读数条件、权限、采样频率须按对应 API reference 和设备能力矩阵验证。 | Zepp OS 是表端应用生态;此次官方公开检索没有找到适用于普通第三方、读取 Zepp/Zepp Life 账号历史汇总的通用用户云 API 证据。因此 Zepp OS API、Mi Fitness 云 API、老小米运动开放平台和 Zepp Life App 数据不能并为一条“都可读”的路线。 |
| 6 | 旧版小米健康云 / 小米运动开放平台文档(历史/合作伙伴线索) | 小米官方旧文档自述“小米健康云”当时只对小米生态链企业及合作伙伴正式开放,要求先建数据源,再读写对应数据。公开旧 GitHub Wiki(华米维护仓库)曾列小米运动 App 的 OAuth/API 接入方式,但它不是当前开发者门户承诺。 | 旧健康云模型以 DataPoint 为采样最小单位,可保存可穿戴设备数据;具体运动类型/字段由数据源定义。 | 该页面年代约 2018,旧 Wiki 约 2017–2018,不能据此说今天普通开发者仍可申请或 Zepp Life 当前仍沿用同接口。当前路线应以小米澎湃 OS 开发者平台新的“小米运动健康数据平台”指南为准;OtterLife FAQ 可证它当前产品文档声称支持该消费者路径,但未揭示底层实现。 |
关键解读
- 华为有两条不同的开发路线。 Android 端设备/应用本地 SDK 与云端 REST 均有官方文档;iOS 页面标示 Health Kit 可用,但不能将 Android SDK 方案直接外推至 iOS。云 REST 更适合跨移动平台的账号授权读取,代价是要处理同步、授权、审核与服务端集成。
- 小米当前有明确的官方云数据接口。 它对普通开发者开放“申请”而非免审核即用;申请账号服务、开通健康服务、申请权限、用户授权构成门槛。类型目录比较丰富,但没有逐设备保证字段、无端到端延迟承诺,也不等于任何第三方 App 现成兼容。
- Zepp OS、Zepp Life 和 Mi Fitness 是不同概念。 Zepp OS 给开发者做表端应用;Mi Fitness 当前云 API 是用户账号授权后的服务端读取;Zepp Life 的现行通用第三方历史数据 API 未在此次官方检索中确认。OtterLife FAQ 是它自身当前支持说明,不能替代平台接口文档,也没有公开其小米底层路线。
- 不要从类型名推导生理信号质量或精确度。 例如
heart_rate、睡眠健康记录和“活力指标”说明接口对象/平台派生值,不代表浮光直接取得传感器波形,也不代表可跨设备比较。时间戳、来源、修改时间、时区和重叠记录处理需保留。
证据性质与未知
- 小米、华为开发者文档:平台官方对接方式和接口能力描述;非实际用户授权后的读取测试。
- OtterLife FAQ:OtterLife 官方帮助中心对当前支持产品、系统路线和常见故障的产品自述;可证明其公开声明,不揭示未公布的接口实现,也不证明用户实际账户必有数据。
- 旧小米健康云/华米 Wiki:仅历史生态线索,不能用于当前准入结论。
- 尚待实测/申请验证:具体设备型号与固件可产出哪些数据、各地区/系统版本的可用性、第三方正式 scope 审批结果、真实同步延迟与补传行为、Mi Fitness 与 Zepp Life 两条 OtterLife 路线的精确字段集合及底层 API。
Source URLs
- Huawei Health Kit 产品与支持平台:https://developer.huawei.com/consumer/en/hms/huaweihealth/
- Huawei 登录与授权 scope:https://developer.huawei.com/consumer/en/doc/HMS-Plugin-Guides-V1/signing-in-and-pplying-for-permissions-0000001074001642-V1
- Huawei 正式 scope 申请、100 测试用户、审核时限:https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides/verification-0000001211587947
- Huawei Android 端健康数据查询:https://developer.huawei.com/consumer/de/doc/HMSCore-Guides/datacontroller-develop-0000001050071677
- Huawei 运动记录字段、来源、详情 scope:https://developer.huawei.com/consumer/en/doc/HMSCore-Guides/extended-querying-dailyactivities-0000001053213332
- Huawei iPhone 授权/版本/手动云同步故障排查:https://developer.huawei.com/consumer/fr/doc/hmscore-guides/faq-0000001467892241
- Xiaomi 当前运动健康服务端接入、OAuth、权限目录、事件订阅、查询窗口:https://dev.mi.com/xiaomihyperos/documentation/detail?pId=2333
- Xiaomi 历史健康云开放平台(仅生态链企业与合作伙伴):https://dev.mi.com/docs/micloud/health/
- Xiaomi 手环绑定官方帮助(连接小米运动 App):https://www.mi.com/service/smart/shouhuan/Connect
- Zepp OS 官方开发者门户:https://developer.zepp.com/os/develop
- Zepp OS 传感器 API 能力示例(官方活动说明):https://developer.zepp.com/os/activity-hackathon-2024
- OtterLife 官方 FAQ(支持矩阵、iOS Health、Android 华为云、小米/Zepp Life、运动记录、延迟说明):https://docs.otterlife.app/zh/faq
- 历史小米运动 App API 指南(华米仓库 Wiki,历史材料):https://github-wiki-see.page/m/zepp-health/rest-api/wiki/%E5%B0%8F%E7%B1%B3%E8%BF%90%E5%8A%A8App%E5%86%85%E6%B4%BB%E5%8A%A8%E6%8E%A5%E5%85%A5%E5%BC%80%E6%94%BE%E5%B9%B3%E5%8F%B0API%E6%8C%87%E5%8D%97