心率通知 - JSON 匯出格式

JSON 匯出中心率通知結構的文件

Last updated: February 6, 2026

On this page

心率通知

心率通知包括來自 Apple Watch 的高心率和低心率警示、不規則心律通知，以及在這些事件期間收集的詳細心率資料。在 JSON 匯出中，心率通知儲存在 heartRateNotifications 陣列中。

結構

心率通知資料具有與其他健康指標不同的獨特結構。每個通知包括事件時間、閾值（用於高/低通知）以及事件期間的詳細心率測量值：

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 45,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

欄位

必需欄位

start (日期): 心率通知事件的開始時間，格式為 yyyy-MM-dd HH:mm:ss Z
end (日期): 心率通知事件的結束時間，格式為 yyyy-MM-dd HH:mm:ss Z
heartRate (陣列): 事件期間的心率測量值陣列（見下方心率資料）
heartRateVariation (陣列): 事件期間的心率變異性 (HRV) 測量值陣列（見下方 HRV 資料）

選用欄位

threshold (數字): 觸發通知的心率閾值。僅在高心率和低心率通知中包含。

通知類型

高心率通知

當心率在靜息時超過設定閾值（通常為 100-150 bpm）時觸發。

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": []
}

低心率通知

當心率在靜息時低於設定閾值（通常為 40-50 bpm）時觸發。

{
  "start": "2024-02-06 03:00:00 -0800",
  "end": "2024-02-06 03:05:00 -0800",
  "threshold": 40,
  "heartRate": [
    {
      "hr": 38,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 03:00:00 -0800",
        "end": "2024-02-06 03:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": []
}

不規則心律通知

當 Apple Watch 偵測到可能表示心房顫動的不規則心律時觸發。

{
  "start": "2024-02-06 16:00:00 -0800",
  "end": "2024-02-06 16:05:00 -0800",
  "heartRate": [
    {
      "hr": 85,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 16:00:00 -0800",
        "end": "2024-02-06 16:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 35,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 16:00:00 -0800",
        "end": "2024-02-06 16:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

注意: 不規則心律通知不包含 threshold 欄位。

心率資料

heartRate 陣列包含通知事件期間的詳細心率測量值：

{
  "hr": 105,
  "units": "bpm",
  "timestamp": {
    "start": "2024-02-06 14:30:00 -0800",
    "end": "2024-02-06 14:30:05 -0800",
    "interval": {
      "duration": 5,
      "units": "s"
    }
  }
}

欄位:

hr (數字): 以每分鐘心跳次數表示的心率值
units (字串): 測量單位（每分鐘心跳次數始終為 "bpm"）
timestamp (物件): 此測量值的時間段
- start (日期): 測量時段的開始
- end (日期): 測量時段的結束
- interval (物件): 測量的持續時間
  - duration (數字): 持續時間值
  - units (字串): 單位（秒始終為 "s"）

心率變異性 (HRV) 資料

heartRateVariation 陣列包含心率變異性測量值：

{
  "hrv": 45,
  "units": "ms",
  "timestamp": {
    "start": "2024-02-06 14:30:00 -0800",
    "end": "2024-02-06 14:30:05 -0800",
    "interval": {
      "duration": 5,
      "units": "s"
    }
  }
}

欄位:

hrv (數字): 以毫秒表示的心率變異性值
units (字串): 測量單位（毫秒始終為 "ms"）
timestamp (物件): 與心率時間戳記相同的結構

了解 HRV:

HRV 測量心跳之間的時間變化
較高的 HRV 通常表示更好的心血管健康和壓力恢復
較低的 HRV 可能表示壓力、疲勞或健康問題
HRV 可能因一天中的時間、活動水平和個體因素而有顯著差異

範例：完整通知項目

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    },
    {
      "hr": 108,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:05 -0800",
        "end": "2024-02-06 14:30:10 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 45,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

通知閾值

閾值可在 Apple Health 設定中由使用者配置：

高心率: 通常為 100-150 bpm（預設值因年齡而異）
低心率: 通常為 40-50 bpm（預設值因年齡而異）

threshold 欄位顯示觸發通知的確切閾值。

裝置需求

心率通知需要：

Apple Watch Series 1 或更新機型（用於基本心率監測）
Apple Watch Series 4 或更新機型（用於不規則心律通知）
WatchOS 5.1.2 或更高版本（用於不規則心律通知）
在 Apple Health 設定中啟用通知

使用場景

心率通知資料可用於：

健康監測: 追蹤心率何時超過正常範圍
AFib 偵測: 監測不規則心律通知以發現潛在的心房顫動
醫療記錄: 與醫療保健提供者共享通知事件
模式分析: 識別心率事件中的觸發因素或模式
健身洞察: 透過 HRV 資料了解恢復和壓力反應
症狀關聯: 將通知與症狀、活動或藥物進行交叉引用

重要提示

非醫療裝置: Apple Watch 通知並非旨在替代專業醫療診斷
諮詢醫療保健提供者: 始終就心率通知諮詢醫療專業人員，尤其是不規則心律警示
上下文很重要: 心率可能因運動、壓力、咖啡因、藥物或其他因素而升高
AFib 通知: 不規則心律通知可能表示心房顫動，應與醫療保健提供者討論

提示

查看通知: 定期查看心率通知以識別模式
記錄上下文: 考慮通知發生時您在做什麼（運動、壓力、睡眠等）
追蹤趨勢: 隨時間監控通知頻率和模式
結合 ECG: 將不規則心律通知與 ECG 讀數進行交叉引用，以進行全面的心臟健康監測