將 Apple 健康資料同步到 Home Assistant
將健康資料與 Home Assistant 整合。
最後更新: 2026年10月31日
將健康指標作為單獨的實體狀態發佈到 Home Assistant。此目的地僅支援健康指標。
重要 — 自動化限制: 讀取健康資料時裝置必須解鎖,且 iOS 不保證按你選擇的頻率執行背景執行。依賴自動匯出前,請先查看自動化限制。
開啟自動化
在 iPhone 上開啟 匯出 → 自動化,或在 iPad 側邊欄開啟 自動化。選擇 新增自動化,或開啟現有自動化進行編輯。
名稱、狀態與通知
輸入用於識別此自動化的名稱。啟用 允許自動執行;準備好之前請保持關閉。
選擇所需的執行通知:
- 快取更新時通知 報告匯出資料已準備好。
- 執行時通知 報告已成功發佈到 Home Assistant。
出現提示時請允許通知。這些通知報告活動,不會安排執行。
連線 Home Assistant
- 將 自動化類型 選為 Home Assistant。
- 輸入 Home Assistant 實例的基礎 URL,例如
http://homeassistant.local:8123。 - 在 Home Assistant 個人檔案中建立長期存取權杖。
- 在 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。
匯出歷史或遺漏的資料
首次設定自動化時使用 手動上傳 匯出歷史資料,或之後補齊自動同步遺漏的日期。也可用於檢查設定。
- 開啟自動化,在 匯出現有資料 下選擇 手動上傳。
- 設定 開始 和 結束 日期,然後選擇 開始匯出。
- 在 Home Assistant 中開啟 開發人員工具 → 狀態,搜尋該自動化的
hae.前綴。 - 檢查實體值和更新時間。
疑難排解
- 身份驗證錯誤: 檢查權杖和
Authorization: Bearer ...標頭。 - 連線失敗: 檢查基礎 URL、連接埠、網絡存取和憑證信任。
- 部分讀數缺失: 檢查所選日期、來源和活動記錄。一次執行可能更新部分實體而其他失敗。
開啟自動化並選擇 檢視活動記錄 以檢查失敗步驟。如需支援,請參閱取得協助。