帮助中心 HealthyApps
简体中文
帮助中心
主网站 ↗

搜索帮助主题

将 Apple 健康数据同步到 Home Assistant

将健康数据与 Home Assistant 集成。

最后更新: 2026年10月31日

本页目录
打开自动化名称、状态和通知连接 Home Assistant健康指标设置
导出设置 导出设置 日期范围时间分组
排程提醒同步频率并保存发布的实体导出历史或遗漏的数据故障排除

将健康指标作为单独的实体状态发布到 Home Assistant。此目标仅支持健康指标。

重要 — 自动化限制: 读取健康数据时设备必须解锁,且 iOS 不保证按您选择的频率执行后台运行。依赖自动导出前,请先查看自动化限制。

打开自动化

在 iPhone 上打开 导出 → 自动化,或在 iPad 边栏打开 自动化。选择 新建自动化,或打开现有自动化进行编辑。

名称、状态和通知

输入用于识别此自动化的名称。启用 允许自动运行;准备好之前请保持关闭。

选择所需的运行通知:

  • 缓存更新时通知 报告导出数据已准备好。
  • 运行时通知 报告已成功发布到 Home Assistant。

出现提示时请允许通知。这些通知报告活动,不会安排运行。

连接 Home Assistant

  1. 将 自动化类型 选为 Home Assistant。
  2. 输入 Home Assistant 实例的基础 URL,例如 http://homeassistant.local:8123。
  3. 在 Home Assistant 个人资料中创建长期访问令牌。
  4. 在 HTTP 标头 下添加键 Authorization,值为 Bearer YOUR_LONG_LIVED_ACCESS_TOKEN。

Home Assistant 实例必须可从 iPhone 或 iPad 到达。对于 HTTPS,请使用设备信任的证书。

健康指标设置

打开 选择健康指标 并选择要发布的读数。

打开 首选来源 为每个指标选择来源。对所有未排除来源使用 全部,或使用 排除的来源 在此自动化中忽略某个来源。排除优先,未选来源不会在首选来源没有数据时替代。选择 保存 应用,或 取消 丢弃。

导出设置

Home Assistant 使用自己的 JSON 实体状态格式;没有文件格式或导出版本选项。

日期范围

  • 默认: 包含前一天以及运行时刻之前的今天。
  • 今天: 包含运行时刻之前的今天。
  • 昨天: 包含前一个完整日。

时间分组

选择 默认 保持读数不分组,或选择 日 使用每日摘要。Home Assistant 没有 汇总数据 开关。

排程提醒

若希望收到解锁并打开 App 的提示,请打开 启用提醒。选择 每小时、每天 或 选定日期,然后按需设置分钟、时间和日期。出现提示时允许通知访问;若被拒绝,请使用 打开通知设置。

提醒不会运行自动化,也不确认同步成功。点按可打开自动化,或使用通知上的 打开并同步 请求运行。自动化必须已启用;后台运行成功后仍可能出现提醒。提醒更改在保存时应用。

同步频率并保存

在 同步频率 下选择数字以及 分钟 或 小时。这是期望的后台节奏,不是保证的排程。

读取健康数据时设备必须解锁。为 Health Auto Export 启用后台 App 刷新,并为自动运行关闭低电量模式。设备长时间未使用或系统资源有限时,iOS 仍可能延迟运行。

准备好自动运行时打开 启用,然后选择 更新 保存自动化。可按下列步骤立即上传选定日期范围。

发布的实体

每个选定指标可生成一个或多个实体。标识符以 hae. 开头,后跟不含空格的小写自动化名称,再跟指标和任何组件名称。

例如,名为 Health Metrics 的自动化可将步数发布到:

http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count

状态是所选日期的最新读数,并带有测量单位属性。血压和心率等指标使用单独的组件实体。

某天没有数据时,步数和站立小时等合计会发布 0。体重或心率等其他读数在有数据之前不会更新,因此 Home Assistant 可能继续显示上次收到的值。一天较早时,在 Watch 数据到达 iPhone 之前合计可能保持为 0。

导出历史或遗漏的数据

首次设置自动化时使用 手动上传 导出历史数据,或之后补齐自动同步遗漏的日期。也可用于检查设置。

  1. 打开自动化,在 导出现有数据 下选择 手动上传。
  2. 设置 开始 和 结束 日期,然后选择 开始导出。
  3. 在 Home Assistant 中打开 开发者工具 → 状态,搜索该自动化的 hae. 前缀。
  4. 检查实体值和更新时间。

故障排除

  • 身份验证错误: 检查令牌和 Authorization: Bearer ... 标头。
  • 连接失败: 检查基础 URL、端口、网络访问和证书信任。
  • 部分读数缺失: 检查所选日期、来源和活动日志。一次运行可能更新部分实体而其他失败。

打开自动化并选择 查看活动日志 以检查失败步骤。如需支持,请参阅获取帮助。