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

搜尋說明主題

心率通知 - JSON 匯出格式

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

最後更新: 2026年10月31日

本頁內容
結構
欄位 欄位 必填欄位可選欄位
心率資料相關文件

心率通知包括 Apple Watch 的高/低心率警報、不規則節律通知,以及這些事件期間收集的心率樣本。在 JSON 匯出中,心率通知儲存在 heartRateNotifications 陣列中。

結構

每條通知包含事件時間、可選閾值(用於高/低通知)、來源資訊,以及事件開始與結束之間的數量序列心率樣本:

{
  "heartNotification": "high_heart_rate_notification",
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "source": {
    "name": "Apple Watch",
    "identifier": "com.example.recorder"
  },
  "heartRateData": [
    {
      "qty": 105,
      "units": "count/min",
      "start": 1707258600,
      "end": 1707258605
    }
  ]
}

欄位

必填欄位

  • heartNotification(字串):通知類型識別碼
  • start(日期):心率通知事件開始時間,格式為 yyyy-MM-dd HH:mm:ss Z
  • end(日期):心率通知事件結束時間,格式為 yyyy-MM-dd HH:mm:ss Z
  • source(物件):記錄通知的裝置/來源
    • name(字串):人類可讀的來源名稱
    • identifier(字串):來源套件識別碼
  • heartRateData(陣列):事件視窗期間的心率數量樣本(見下方心率資料)

可選欄位

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

心率資料

heartRateData 陣列包含通知事件視窗期間的數量序列心率測量。每個樣本包含 qty、units、start 和 end:

{
  "qty": 105,
  "units": "count/min",
  "start": 1707258600,
  "end": 1707258605
}

欄位:

  • qty(數字):心率值
  • units(字串):測量單位(通常為 "count/min")
  • start(數字):測量時段開始,為 Unix epoch 秒
  • end(數字):測量時段結束,為 Unix epoch 秒

相關文件