心率通知 - 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 检测到可能表示心房颤动的 irregular 心律时触发。

{
  "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 读数进行交叉引用，以进行全面的心脏健康监测