幫助中心 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、連接埠、網絡存取和憑證信任。
  • 部分讀數缺失: 檢查所選日期、來源和活動記錄。一次執行可能更新部分實體而其他失敗。

開啟自動化並選擇 檢視活動記錄 以檢查失敗步驟。如需支援,請參閱取得協助。