📁 指标总览

HealthKit 运作原理

本技术指南将深入浅出地介绍 Apple 健康是如何存储和组织您的健康数据的。


什么是 HealthKit?

HealthKit 是 Apple 开发的健康与健身数据框架。它作为一个核心存储库,具有以下功能:

  • 集中存储来自多个来源(如 Apple Watch、iPhone、第三方 App)的健康数据。
  • 确保所有健康指标具备统一的数据格式。
  • 实施颗粒度极细的隐私权限管理。
  • 实现授权 App 之间的数据互通与分享。

数据是如何存储的

HealthKit 将数据存储为类型化样本 (Typed Samples),通常包含以下核心要素:

要素项说明示例
开始/结束时间测量发生的具体时刻2025-01-15 08:30:00
数值 + 单位测量结果的具体读数72 bpm
来源及设备写入该数据的 App 或硬件设备Apple Watch Series 9
元数据 (Metadata)数据的额外补充背景训练类型、设备佩戴位置等

样本类型

数值样本 (Quantity Samples)

带有计量单位的数字读数。

示例: - 步数(总计)。 - 心率 (bpm)。 - 血糖 (mg/dL)。 - 距离(米)。 - 能量消耗 (kcal)。

分类样本 (Category Samples)

来自预定义集合中的枚举值。

示例: - 睡眠阶段(REM 睡眠、核心睡眠、深度睡眠、清醒状态)。 - 经期流量(轻微、中度、大量)。 - 正念记录(是否存在记录)。

关联样本 (Correlation Samples)

共同存储的一组相关样本。

示例: - 血压(收缩压 + 舒张压)。 - 饮食记录(一次进餐中包含的多种营养素)。

体能训练样本 (Workout Samples)

结构化的活动会话记录,包含: - 活动类型(跑步、游泳、骑行等)。 - 开始和结束时间。 - 总能量消耗。 - 移动距离(如适用)。 - 路线坐标数据(如有记录)。

医疗记录

在所在地区及医疗服务商支持的前提下,包含: - 化验结果。 - 免疫接种记录。 - 药物使用情况。 - 临床文档。


数据来源

HealthKit 可以接收来自多个渠道的数据:

Apple 设备

  • Apple Watch - 监测心率、活动能力、体能训练、心电图、睡眠以及血氧。
  • iPhone - 通过运动传感器统计步数、步行距离和爬楼层数。

第三方设备

  • 智能体重秤(测量体重、身体成分)。
  • 智能血压计。
  • 智能血糖仪。
  • 第三方睡眠监测追踪器。

手动录入

  • 在 Apple “健康”App 中由用户自行录入的数据。
  • 通过支持 HealthKit 的第三方 App 录入的数据。

医疗机构集成

  • 从支持的医疗服务提供商处同步的临床记录。
  • 各类实验室化验结果(视具体供应商而定)。

来源优先级

当多个来源同时记录同一项指标时,HealthKit 会依据以下规则决定显示的优先级:

  1. 用户手动录入的数据通常具有最高优先级。
  2. 来自所佩戴传感器的原生设备数据。
  3. 第三方 App 产生的数据。

您可以在 Apple 健康的设置中自行管理各个来源的优先级顺序。


隐私架构

HealthKit 的隐私模型是其设计的核心基石:

按类型细分的权限控制

App 只能请求对特定数据类别的访问权限,而非全部健康数据。您可以选择授予: - 仅读取权限。 - 仅写入权限。 - 同时授予读写权限。 - 拒绝授权。

用户自主掌控

  • 可随时在“设置 > 健康 > 数据访问与设备”中审核权限。
  • 可随时撤销已授予的权限。
  • 可以精确查看哪些 App 在何时访问了哪些特定数据。

本地设备存储

  • 健康数据存储在您的 iPhone 本地。
  • 通过您的设备锁屏密码进行加密保护。
  • 仅在 iCloud 设置中手动开启“健康”同步时,数据才会备份到 iCloud 并进行端到端加密。

常见 HealthKit 标识符

每种数据类型在系统中都有唯一的标识符名称,例如:

指标HealthKit 内部标识符
心率HKQuantityTypeIdentifier.heartRate
步数HKQuantityTypeIdentifier.stepCount
睡眠分析HKCategoryTypeIdentifier.sleepAnalysis
最大摄氧量HKQuantityTypeIdentifier.vo2Max
血压HKCorrelationTypeIdentifier.bloodPressure

参考文献

Expertly Reviewed by

This content has been written and reviewed by a sports data metrics expert to ensure technical accuracy and adherence to the latest sports science methodologies.

HealthKit 运作原理 - 将 Apple Health 数据导出至 CSV、PDF 和 JSON...

本技术指南将深入浅出地介绍 Apple 健康是如何存储和组织您的健康数据的。 HealthKit 是 Apple 开发的健康与健身数据框架。它作为一个核心存储库,具有以下功能: HealthKit 将数据存储为 类型化样本 (Typed Samples) ,通常包含以下核心要素:

  • 2026-01-26
  • HealthKit · 运作原理 · 数据存储 · 隐私架构
  • 参考书目