设备与手机数据链路发现(16 组)
检索日期:2026-10-01。范围限用户主要关心的手机、手表,并补充戒指、体重秤、胸带、床旁睡眠传感器。以下“可读字段”仅指官方 API/SDK 明列的数据;可用性还受设备、同步、地区、OS 及用户授权影响。测量/估算用“测量”表示传感器直接观测(仍含设备采样与处理),“估算/派生”表示算法输出;厂商未公开原始算法的,不推测公式。
本表据官方开发者资料整理,未连接真实健康账户或购买设备。字段目录不等于指定设备实际产出,也不等于浮光已获正式接入资格。国内华为、小米与Zepp路线见国内生态,研究覆盖范围见证据阶段。费用/准入限制在各行说明。
Fitbit正处接口关闭迁移窗口,历史API字段仅用于理解机制;2026-10-01的新项目可行性以平台边界中的当前Google准入说明为准,不能把旧API作为首期上线承诺。
| # | 产品/设备组合 | 用户任务 | 传感器/测量与估算区分 | App 路线 | 官方明确数据字段 | 限制 / 准入 | 官方资料 | 值得深挖理由 |
|---|---|---|---|---|---|---|---|---|
| 1 | iPhone 原生步行计步(CMPedometer) | 无手表时估算日常活动量 | iPhone 内置运动协处理器产生系统步行/跑步统计;步数为系统识别结果,距离、配速及楼层为近似/估算值 | 第三方 iOS App → Core Motion → CMPedometer 的历史查询或实时更新;Motion 使用说明弹窗 | numberOfSteps、distance、currentPace、currentCadence、floorsAscended、floorsDescended |
要求设备支持;须声明 NSMotionUsageDescription 并获准;楼层可为 nil;该路由是手机佩戴/携带状态下数据,不等于手表全天佩戴 |
CMPedometer, CMPedometerData | 很适合研究“不戴外设时,手机持有/放置位置如何改变被动数据覆盖” |
| 2 | Android 手机步数传感器 | 低功耗手机计步 | 系统步数传感器输出累计步数,传感器端已做步态检测;不直接给出行走距离 | 第三方 Android App → SensorManager → TYPE_STEP_COUNTER,或逐步 TYPE_STEP_DETECTOR |
Step Counter 的 SensorEvent.values[0]:自上次重启且传感器启用以来的步数总计;Step Detector 每步产生事件 |
Android 10+ 需要 ACTIVITY_RECOGNITION;存在传感器与设备支持差异;累计值跨重启需自行分段;没有官方说法支持将其当作手表步数源 |
Android motion sensors | 可直接比较手机原生事件流、聚合健康仓库和厂商 App 汇总之间的信息损失 |
| 3 | iPhone 原生运动状态识别(Core Motion) | 识别用户大致活动状态与状态切换 | 系统分类器用设备运动传感器推断活动类别,不是 GPS 定位或人工确认 | 第三方 iOS App → Core Motion → CMMotionActivityManager 查询/订阅 |
活动类型 walking、running、automotive、stationary、cycling、unknown;分类置信度与时间戳 | 须请求运动使用授权;后台更新受系统调度/权限影响;返回类别是系统估算标签,非传感器原始波形,不能推出连续轨迹 | Core Motion | 可研究“事件标签”而非精细生理指标如何支持生活节律推断,及分类缺失时的边界 |
| 4 | Android 手机加速度计 / 陀螺仪 | App 自行识别动作、久坐或移动 | 加速度计测三轴加速度、陀螺仪测角速度;动作/姿势/久坐段需 App 自己推断 | 第三方 App → Android Sensor Framework → 注册 sensor listener 获取事件 | SensorEvent.values[] 三轴数值、timestamp、accuracy;具体精度/坐标系由传感器类型说明 |
需按权限和 OS 版本管理采样;采样频率、后台运行、耗电、设备是否具备传感器各有差异;官方 API 不直接提供“睡眠/情绪/步态”等语义结果 | Sensors overview, Motion sensors | 适合把“硬件原始数据可读”与“模型推断可复现/可解释”拆成不同研究问题 |
| 5 | Apple 健康 App / HealthKit 跨设备仓库(iPhone App) | 一个 App 汇总 iPhone、Apple Watch 与第三方 App 写入的健康记录 | HealthKit 是数据仓库与访问框架;数据测量源由 sample 的来源元数据决定,HealthKit 不代表 iPhone 本机测得 | iOS App 声明 HealthKit capability → 按类型申请读授权 → query store | 类型含 step count、walking/running distance、heart rate、resting heart rate、HRV、respiratory rate、sleep analysis 等;具体为带时间区间/来源的 samples | 每种类型单独授权;用户拒绝读取时 App 无法区分“拒绝”与“没有数据”;可只开放有限历史范围;必须提供隐私说明;Apple 平台要求健康用途合规 | HealthKit data types, 授权访问 | 核心跨设备聚合路线,可验证第三方接入时设备源、样本时间、授权窗口及数据稀疏度 |
| 6 | Apple Watch → iPhone → HealthKit | 日常活动、心率与睡眠回顾 | 手表光学/运动传感器与厂商算法生成样本;阶段、VO₂ max 等为算法性指标。HealthKit 读取不直接提供未公开原始传感器流 | Watch / iPhone 将样本同步 HealthKit;第三方 iOS App 读授权类型 | HealthKit 可读取的类型例如 steps、heart rate、HRV、respiratory rate、oxygen saturation、sleep analysis、ECG sample;Apple 明确支持的类型不等于每台表/地区都有值 | 用户须有兼容设备且完成同步;每类型授权;部分指标因型号、地区、功能启用而缺失;ECG 不应称为诊断数据;HealthKit 不让 App 靠设备型号推定字段必有 | HealthKit data types, HealthKit 隐私 | 可追踪从腕上采样到系统仓库再到研究 App 的多段延迟、来源标记和缺失机制 |
| 7 | Android Health Connect(手机 + 手表/健康 App 生态) | Android 上跨 App 查看活动、生命体征、睡眠 | Health Connect 是本机标准化数据仓库;记录仍来自手机、手表或其他 App,不可默认由手机测得 | Android App → Health Connect SDK → 为所需 Record 类型声明并请求用户权限 | 明确 Record:StepsRecord.count/startTime/endTime、HeartRateRecord.samples、SleepSessionRecord.startTime/endTime/stages、WeightRecord.weight、RespiratoryRateRecord.rate 等 |
Manifest 声明后逐类型申请;后台读取需额外权限;超过 30 天历史需 READ_HEALTH_DATA_HISTORY;发布到 Play 还涉及健康数据声明/特殊审批;用户可撤销 |
Health Connect 数据类型与权限, 睡眠记录 | 与 HealthKit 对照可看 Android 开放生态里来源合并、后台历史权限和字段粒度的差异 |
| 8 | Samsung Galaxy Watch / Galaxy Ring → Samsung Health Data SDK | Galaxy 设备睡眠、步数、连续心率同步到第三方 App | Galaxy 设备传感器数据经 Samsung Health 同步;睡眠分期、睡眠分数、能量分数等是平台派生结果 | Android App → Samsung Health Data SDK → 指定数据类型请求用户授权;数据先存在 Samsung Health | SleepType: startTime/endTime、duration、sessions、sleep score;睡眠关联数据可读血氧/皮温;HeartRateType: start/end、heart rate、series data、min/max;StepsType: 总步数聚合 |
依赖 Samsung Health 与支持设备同步;用户逐类同意及 SDK 服务政策;设备型号/版本影响字段;旧 Samsung Health SDK 已于 2025-07-31 弃用,须走新 Data SDK,后者可能要求合作伙伴准入 | Data SDK 概览, 睡眠字段, 心率字段 | 单一厂商仓库同时囊括手表、戒指与手机步数,能研究多源去重及隐式来源管理 |
| 9 | Garmin 手表 → Garmin Connect Health API | 企业健康/运动服务导入全天健康摘要 | 设备传感器与 Garmin 计算指标上传至 Garmin Connect;全天摘要、压力、Body Battery、睡眠等为产品计算数据 | 合作方服务器 → Garmin Health API → 用户授权并同步 Connect 后拉取或接收 JSON | 官方列举 Steps、Intensity Minutes、Sleep、Calories、Heart Rate、Stress、Pulse Ox、Body Battery、Body Composition、Respiration、Blood Pressure、Beat-To-Beat intervals 和 epoch summaries | 非普通任意第三方即用 API:须申请并经批准;商业用途需要许可费;先连接 Garmin Connect 同步;服务面向企业/人群健康方案 | Garmin Health API | 适合对照“开放的手机 API”与“需商业伙伴许可的穿戴云 API”,研究接入成本和摘要化 |
| 10 | Fitbit / Pixel Watch → Fitbit Web API(迁移期) | 用户授权第三方读取 Fitbit 账号历史 | Fitbit/Pixel Watch 的设备数据先进入账号云端;睡眠、HRV、呼吸频率等是设备/平台处理的结果 | OAuth Web API;按活动、心率、睡眠、HRV、呼吸速率等 endpoint 拉取 | 官方 API 文档列举 daily activity/time series、heart intraday(1s/1m/5m/15m)、sleep logs/stages、HRV 的 RMSSD/LF/HF/coverage、breathing rate、weight/body fat | Fitbit intraday 的第三方多用户访问需申请;OAuth scope/审核限制;Google 正在迁移开发者接口,官方文档提示 Fitbit Web API 走向停用,应在开发前复核当期迁移窗口与替代方案;不可将旧端点当长期稳定承诺 | Fitbit API Explorer, Fitbit 心率 intraday 准入, Google Fit / Fitbit API 迁移说明 | 历史 API 字段丰富且有高频样本,但即将迁移使“研究可复现性依赖平台周期”本身值得研究 |
| 11 | Oura Ring → Oura Cloud API | 睡眠、准备度、活动与夜间生理趋势 | 指环传感器数据经 Oura 算法生成汇总/评分;Readiness、sleep score、睡眠阶段属于厂商处理结果 | 用户在 Oura App 同步 → OAuth2 API v2 scopes → 用户授权后第三方读取云端记录 | 官方 scopes 包括 daily summaries(睡眠/活动/准备度)、Gen3 heart rate time series、workout、personal、SpO₂ sleep average、session、tag | Oura 官方 API 入门页明示 API 应用默认上限 10 用户,扩大用户群需审核;该页同时标为 V1 入门文档,V1 已于 2024-01-22 移除,因此把 10 人/审核作为官方门户当前公开准入提示,正式依赖前应向 V2/新门户再次确认。另:Gen3 及更新代用户必须有有效 Oura Membership 才能通过 API 访问数据;仍需 Oura 账号、App 同步、用户 OAuth 授权 | API 文档及默认限额, V2 scope, Oura API 会员限制(官方中文) | 戒指的长时佩戴和云端授权是研究“低负担睡眠监测”及准入差异的代表路线 |
| 12 | WHOOP Band → WHOOP Developer API | 训练负荷、恢复与睡眠质量分析 | 光学心率等传感数据经 WHOOP 形成 Strain/Recovery/Sleep score;不把评分误当原始测量 | OAuth2 API,按 scope 请求 recovery、cycles、workout、sleep、profile、body measurement | recovery:score、HRV、resting HR;cycle:day strain、平均心率;workout:activity strain、average HR;sleep:performance、各阶段时长;profile:height、weight、max HR | 用户授权具体 scope;API / Trusted Partner 有不同方式;开发者账号与合作计划要求需按项目规模确认;数据依赖设备上传云端 | WHOOP Developer API | 产品把原始生理信号压缩为行为评分,适合研究第三方究竟能访问样本还是只能取得厂商特征 |
| 13 | Withings Body+ / Body Comp 等 Wi-Fi 体重秤 → Withings API | 体重趋势、体成分趋势 | 体重为秤上负载传感器测量;脂肪/水分/肌肉等为阻抗与算法估值,API 的字段名不代表临床直接测量 | 秤 → Withings App/云同步 → OAuth2 Withings API Measure v2 | meastype: 1 weight、5 fat-free mass、6 fat ratio、8 fat mass、76 muscle mass、77 hydration、88 bone mass、170 visceral fat 等(设备可用性各异);时间戳、分组与测量值 |
数据须先同步至 Withings 服务器;用户 OAuth 授权;需应用/项目准入;并非所有秤都有全部类型;测量需结合设备官方说明解释 | Withings API Measure | 对比“传感器直接称重”和算法体成分字段,适合研究精度/置信度如何在 API 层被隐去 |
| 14 | Withings Sleep / Sleep Analyzer 床垫下睡眠垫 → Withings API | 无腕戴设备的卧床、睡眠和夜间呼吸趋势 | 床垫下气动传感器测量身体机械变化(心搏、呼吸、运动);睡眠阶段及评分是厂商算法输出,算法公式未公开 | 垫子 → Wi-Fi / Withings App 同步至云端 → OAuth API Sleep v2 | Sleep v2 Get 高频接口明确列出 hr、rr、snoring、sdnn_1(1 分钟 NN 间期标准差)、rmssd(短窗口 successive differences 均方根)、hrv_quality、mvt_score 等;summary 另有睡眠时长/阶段、睡眠效率、夜间 HR/RR 汇总 |
API 明确要求以 Available Health Data 型谱/地区表核对指标,不能把目录字段视为每款睡眠设备都有。官方表注明 Sleep 与 Sleep Rx 仅美国可用,Sleep Analyzer 仅欧盟、澳大利亚、英国可用;movement score / mvt_score 仅 Sleep Analyzer(EU)与处方 Sleep Rx(US),且存在地区监管及 API plan 限制。读取前必须先同步云端;高频 Get 每次窗口最多返回 startdate 后 24 小时 | Sleep v2 API 字段, Available Health Data 型谱和地域表, Sleep Analyzer 气动传感器说明 | 非穿戴的家居传感器补齐“夜间/卧床”观测;需要按地区与具体产品筛选,适合与手表夜间数据比较 |
| 15 | Polar H10 胸带 → Polar BLE SDK 直连手机 | 运动时采集胸带心率、RR 间期及 ECG / 加速度流 | H10 胸部电极 ECG;HR 与 RR interval 是设备解析字段,ECG 为 µV 样本,加速度为三轴样本。Polar 文档中的 PPI 是光学 PPG 设备概念,不应套用为 H10 数据 | 第三方 iOS / Android App → 官方 Polar BLE SDK → BLE 连接 H10,启用 H10 对应 SDK feature 并等待设备报告 ready | H10 产品专页明确列出:HR(bpm)与 RR interval(ms),1 Hz;ECG(µV),130 Hz;加速度 25/50/100/200 Hz、2G/4G/8G 档位、轴向 mG;内部录制支持 HR 1 秒采样间隔、单次存一条记录 | H10 专属能力清单没有列 PPG,不能把 SDK 对其他 Polar 光学设备支持的 PPG/PPI 当作 H10 可读。须处理 BLE 与手机附近设备权限;实际功能需运行时确认设备/固件 feature readiness;内录记录内容与实时流不同 | H10 型号能力表, Polar SDK, PPI 属于光学 PPG 设备的说明 | 胸带的 ECG/RR 路线提供较直接的生理时间序列,可与手表 PPG 及厂商云端摘要比较 |
| 16 | Polar 手表 / 腕带 → Polar AccessLink 云 API | 睡眠、Nightly Recharge、训练与每日心率历史 | 腕上 PPG 与算法衍生的睡眠阶段、夜间恢复估算;API 可返回汇总与部分时间序列 | OAuth 用户连接 → Polar AccessLink API → 用户同步到 Polar Flow | Nightly Recharge:heart_rate_avg、beat_to_beat_avg、heart_rate_variability_avg、breathing_rate_avg、status、HRV/breathing samples;sleep phases 的 wake/REM/light/deep durations;daily continuous HR collection |
需 Polar API 应用/用户授权并将设备同步到 Flow;设备功能决定字段是否生成;部分睡眠阶段无法识别;API 字段是平台分析输出而不是 ECG 原始数据 | Polar AccessLink API, Polar API v4 reference | 同品牌可将胸带的 BLE 原始路线与手表的云端总结路线并列,建立清晰的“源信号—特征—授权”比较 |
推荐代表链路
首选做两条链路的端到端验证:手机原生传感器 → OS API → App(iPhone CMPedometer 与 Android Step Counter),以及 外设 → 厂商同步 App/云 → 第三方授权 API(Withings Sleep 或 Oura Ring)。前者准入低、能直接检查手机持有状态与后台条件;后者能检查用户授权、同步依赖、明确返回字段和厂商算法分数。若重点放在“原始信号可读性”,加 Polar H10 BLE SDK 作第三条,和手表/戒指的云端摘要形成鲜明对照。
可读性边界:官方文档说明 API/schema 和准入,不证明具体账户现有数据完整、不证明数据准确度;本研究未进行设备或账户接入测试。尤其 Garmin 商用许可、Samsung 新 SDK partner policy、Fitbit/Google 迁移时间、地区法规字段可用性,应在项目真实接入前复核。