幫助中心 HealthyApps
繁體中文
幫助中心
主網站 ↗

搜尋說明主題

將 Apple 健康資料同步到 MQTT

將健康資料發佈到 MQTT 代理。

最後更新: 2026年10月31日

本頁內容
開啟自動化名稱、狀態與通知設定連線
資料類型設定 資料類型設定 健康指標體能訓練
匯出設定 匯出設定 匯出版本日期範圍彙總資料與時間分組
排程提醒同步頻率並儲存匯出歷史或遺漏的資料疑難排解

將健康匯出以 JSON 形式發佈到 MQTT 代理上的主題。

重要 — 自動化限制: 讀取健康資料時裝置必須解鎖,且 iOS 不保證按您選擇的頻率執行背景執行。依賴自動匯出前,請先查看自動化限制。

開啟自動化

在 iPhone 上開啟 匯出 → 自動化,或在 iPad 側邊欄開啟 自動化。選擇 新增自動化,或開啟現有自動化進行編輯。

名稱、狀態與通知

輸入用於識別此自動化的名稱。啟用 允許自動執行;準備好之前請保持關閉。

選擇所需的執行通知:

  • 快取更新時通知 報告匯出資料已準備好。
  • 執行時通知 報告已成功發佈到代理。

出現提示時請允許通知。這些通知報告活動,不會安排執行。

設定連線

  1. 將 自動化類型 選為 MQTT。
  2. 輸入代理的主機名稱或 IP 位址以及連接埠。預設連接埠為 1883。
  3. 輸入 主題,例如 health/metrics。
  4. 為每項自動化設定唯一的 用戶端 ID,若代理要求則輸入使用者名稱和密碼。

代理必須可從裝置到達。訂閱者必須使用確切主題(含大小寫)。重複使用用戶端 ID 可能導致代理連線相互取代。

資料類型設定

為此自動化選擇一種 資料類型:健康指標、體能訓練、症狀、ECG、心率通知、心理狀態、週期追蹤或藥物。心理狀態需要 iOS 18 或更高版本;藥物需要 iOS 26 或更高版本以及單獨的藥物存取權限。

健康指標

選擇 健康指標,然後開啟 選擇健康指標 並選擇所需測量值。

若要將讀數限制為特定 App 或裝置,開啟 偏好來源,選擇指標並選擇其來源。全部 允許所有未排除的來源。使用 排除的來源 可在此自動化的健康指標中忽略某個來源。排除優先;偏好來源沒有資料時,不會用未選來源替代。選擇 儲存 套用來源選擇,或 取消 捨棄。

體能訓練

選擇 體能訓練 以匯出體能訓練記錄。包含路線資料 會將可用路線點加入 JSON 體能訓練資料。它不會建立單獨的 GPX 上傳。

對於 版本 2,開啟 包含體能訓練指標 以加入心率、活動能量和步數等讀數。為體能訓練指標 時間分組 選擇 分鐘 或 秒;秒更詳細,匯出也更大。版本 1 一律包含體能訓練指標。

匯出設定

MQTT 僅發佈 JSON。前景發佈使用 QoS 0,背景發佈使用 QoS 1。訊息不會保留。

匯出版本

選擇 版本 2 以使用目前資料結構。現有工作流程依賴舊格式時使用 版本 1。

日期範圍

選擇 包含的資料
預設 前一天以及執行時刻之前的今天
自上次同步以來 自上次同步至執行時刻
今天 執行時刻之前的今天
昨天 前一個完整日
過去 7 天 過去完整的七天

彙總資料與時間分組

對於 JSON + 健康指標,開啟 彙總資料 可將讀數合併到時間分組,或在支援時關閉以保留個別讀數。彙總取決於指標——例如步數合計、體重讀數取平均。CSV 健康指標匯出使用彙總資料。

當 時間分組 可用時,選擇要保留的詳細程度。按小時或按日的分組比按分鐘或秒產生更少的列。可用選項取決於日期範圍和格式。體能訓練時間分組在體能訓練設定中單獨設定。

排程提醒

若希望收到解鎖並開啟 App 的提示,請開啟 啟用提醒。選擇 每小時、每天 或 選定日期,然後按需設定分鐘、時間和日期。出現提示時允許通知存取;若被拒絕,請使用 開啟通知設定。

提醒不會執行自動化,也不確認同步成功。點一下可開啟自動化,或使用通知上的 開啟並同步 請求執行。自動化必須已啟用;背景執行成功後仍可能出現提醒。提醒變更在儲存時套用。

同步頻率並儲存

在 同步頻率 下選擇數字以及 分鐘、小時、天 或 週——例如每 15 分鐘。這是期望的背景節奏,不是保證的排程。

讀取健康資料時裝置必須解鎖。為 Health Auto Export 啟用背景 App 重新整理,並為自動執行關閉低耗電模式。裝置長時間未使用或系統資源有限時,iOS 仍可能延遲執行。

準備好自動執行時開啟 啟用,然後選擇 更新 儲存自動化。可按下列步驟立即上傳選定日期範圍。

匯出歷史或遺漏的資料

首次設定自動化時使用 手動上傳 匯出歷史資料,或之後補齊自動同步遺漏的日期。也可用於檢查設定。

  1. 將 MQTT 訂閱者連線到代理並訂閱設定的主題。
  2. 在 Health Auto Export 中開啟自動化,在 匯出現有資料 下選擇 手動上傳。
  3. 設定 開始 和 結束 日期,然後選擇 開始匯出。
  4. 檢查收到的 JSON 及其日期。

負載遵循 JSON 匯出格式。例如:

{
  "data": {
    "metrics": [
      {
        "name": "step_count",
        "units": "count",
        "data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
      }
    ]
  }
}

疑難排解

  • 連線失敗: 檢查主機、連接埠、網路存取和代理連線要求。
  • 身份驗證失敗: 檢查認證資料以及對主題的發佈權限。
  • 無訊息: 確認訂閱者使用同一代理和確切主題,然後查看活動記錄。
  • 訊息過大: 選擇更少指標、更短範圍或更粗的時間分組。

開啟自動化並選擇 檢視活動記錄 以查看執行。警告 標記潛在問題(例如資料擷取緩慢);錯誤 標識失敗步驟。回報問題的說明請參閱取得協助。