# Apple健康接入链路与页面说明

整理于2026-11-06。交互评审提案，首发字段和真实安装包读取能力尚未冻结或验收。App名称未定，此处使用“本应用”。

主流程采用现有竞品的通行机制：解释导入用途，进入iOS健康授权，回到应用读取记录，再显示数据。以Athlytic官方首次连接为主要证据，OtterLife提供导入入口与权限管理的补充。现有材料不足以证明某款产品恰好具有下面四张连续页面，因此不能把适配稿称作完整逐屏1:1真机复刻。

## 证据与沿用范围

| 参考 | 直接核到的行为 | 本轮怎样沿用 | 不能从材料推出 |
|---|---|---|---|
| Athlytic | 官方说明下载后提示连接Apple健康，系统页选择项目并允许；连接后可读取已有历史记录 | 首次请求及原生系统授权机制，作为主参考 | 没有取得专属“授权成功确认页”或独立读取结果页；权限图可见区主要为写入项目，不当作本产品读取清单 |
| OtterLife | 公开演示的基础资料页有Import Data from AppleHealth；接着出现系统授权，当前截图为生日、身高、性别、体重 | 导入入口与系统接管的关系 | 不是步数/睡眠/心率/训练的完整首次授权证据，不照搬资料请求字段 |
| Bevel | 设备数据来源设置、连接账户、配对和同步；无数据时检查权限及返回刷新 | 后续来源管理和返回重读 | 多设备账户配对不能改名充作Apple健康首次授权 |
| Gentler | 兼容设备先写入Apple健康，应用再读记录；后续活动和睡眠展示 | 已有来源的接入关系及按可读记录呈现 | 未取得Gentler自身完整首次授权画面 |

官方来源：[Athlytic连接Apple健康](https://athlyticapp.helpscoutdocs.com/article/6-connecting-apple-health)、[Athlytic开始使用](https://athlyticapp.helpscoutdocs.com/article/13-getting-started)、[OtterLife FAQ](https://docs.otterlife.app/zh/faq)、[Bevel连接设备](https://help.bevel.health/en/articles/10400449)、[Gentler与智能手表](https://docs.gentler.app/health-insights-and-tips/tracking-with-a-smartwatch)。

## 页面和操作

### 1 连接说明

从生活记录的未连接状态进入，标题“连接Apple健康”。说明连接后可回看日常活动、睡眠和训练；列出拟读取的数据及用途。主按钮“选择共享数据”，次操作“稍后设置”。不要求填写新的每日问卷，不复制竞品的生日、性别、身高、体重填写链路。

点击主按钮才调用系统授权。这里的列表表示“希望读取”，没有授权成功图标、授权比例或自制的系统权限开关。稍后设置可继续进入空状态，也可以后再连接。具体首次入口在岛屿中的位置当前未确定，不新增首页常驻入口。

### 2 iOS系统授权

直接使用HealthKit原生授权页，用户逐项选择愿意共享的记录并在系统内确认。界面布局、类别分组、历史范围和按钮随iOS决定。本应用不制作可控制系统权限的仿制授权页。原型此步明确显示占位，旁边附竞品真实系统图供核对；模拟返回按钮只服务评审，不是产品内多出来的一步。

首次只读接入建议不申请写入。Athlytic示例同时申请读写，不能因为复用其流程就照搬写入范围。权限用途文案须与实际读取和数据用途一致，存储位置、保留时长、用于日记的处理方式仍按后续方案确认，不写“仅本地”或“不上传”的未经确认承诺。

### 3 本次读取结果

系统返回后查询记录，必要时原位显示“正在读取记录”。查询完成的结果页逐项列出“已读取记录”与最近记录/统计窗口，或“暂无可读取记录”。有部分数据便允许继续；没有记录也可以继续查看空状态并提供权限管理指引。请求或查询失败显示“暂时未能读取”，可以重试。

这个页面满足用户确认“现在能看到什么”的需要。它不显示“已授权5项”“剩余3项被拒绝”，也不把请求回调成功当作全量允许。Apple出于隐私保护，不向应用提供完整、可准确判断的健康读权批准清单。只有系统授权页能由用户直接查看自己的开关选择。[Apple授权说明](https://developer.apple.com/documentation/healthkit/authorizing-access-to-health-data)、[授权请求完成含义](https://developer.apple.com/documentation/healthkit/hkhealthstore/requestauthorization(toshare:read:completion:))。

### 4 数据总览

继续后回到生活记录。复用上轮步数时间弧线和睡眠圆盘的图形结构，展示当前能读到的步数、距离、心率、睡眠与运动。无心率或睡眠数据时不填0、不生成阶段；不能把“无睡眠记录”解释为没睡觉。

本轮复制并适配了上一轮低保真，移除爬楼、静息心率和HRV展示，普通心率与本轮候选字段保持一致。保留原稿只是结构复用，示例数值和日期不是用户真实数据，也不代表已接入。完整示例为两条外部训练共30分钟，读取结果页与总览一致；纯活动场景没有外部运动记录，不用站内结算事件补足。

## 候选读取字段

| 展示项目 | 实际读取类型 | 提供什么 |
|---|---|---|
| 步数 | stepCount | 当天总数与分时统计 |
| 步行与跑步距离 | distanceWalkingRunning | 日常移动距离，不由步数反推 |
| 心率 | heartRate | 实际已有样本、采样时间与来源；不是静息心率或HRV |
| 睡眠 | sleepAnalysis | 已入睡区间、时长、起止和已有分期；仅在床区间不等于睡着 |
| 运动记录 | HKWorkout | 已记录的运动类型、日期、时长及关联可用数据；全天步数不会自动变成训练 |

以上为本轮候选范围，不等于首发已定。用户说的“活动”需要映射为具体字段；本稿先由步数/距离表达日常活动，动态能量、Apple锻炼时间和活动圆环是否追加仍待明确。普通心率、静息心率、HRV是三种不同请求，不能相互替代。

系统允许读取和存在样本是两件事。心率、睡眠、训练依赖兼容来源实际写入，未直连手表也可能从Apple健康读取已有设备记录。每类数据带自身时间和来源；应用最近查询时间不代替采样时间。

## 返回和恢复

| 情况 | 页面行为 | 下一步 |
|---|---|---|
| 尚未请求或选择稍后 | 连接说明/总览空态 | 可继续使用，以后再连接 |
| 系统处理了请求 | 开始查询，不能直接宣称全部授权成功 | 按实际结果显示 |
| 部分可读取 | 仅有的指标显示数据，其余为空 | 继续总览或查看权限指引 |
| 查询成功但没有样本 | “暂无可读取记录” | 可继续、查看来源与系统设置、重新读取 |
| 请求或查询失败 | “读取暂未完成”，不要伪造缓存 | 重试或继续；确有旧记录时另标旧数据 |
| 用户取消系统流程 | 回连接说明，保留退出路径 | 不循环强制弹权限 |
| 回到系统修改权限后返回 | 重新查询 | 根据新结果更新，不能只看上次缓存判断当前读权 |

权限指引采用健康App内路径：个人资料 → 隐私下App → 本应用 → 调整类别。若尚未出现本应用，先完成一次权限请求。目标系统各版本需实测，不能承诺一个按钮直达某个健康读权开关；“打开本App设置”也不保证直达健康权限。[Apple管理健康数据](https://support.apple.com/zh-cn/108779)。

## 交付和验收

交互评审文件为同目录“健康接入_交互评审.html”。场景切换位于手机外，演示完整记录、只有活动、无可读记录、查询失败。系统授权仅占位，真实请求、写入来源聚合、跨夜睡眠归并、缓存、撤权后的保留和真实设备查询仍需安装包验证。

入口的最终位置、首发精确类型、是否单列读取结果页或短暂显示后直接进入总览、写入需求和数据保留规则当前未确定。外部健康记录不据此新增或改变行动完成、元气或CC结算规则。
