HealthyApps Help Center

ECG - JSON 导出格式

JSON 导出中 ECG 结构的文档

Last updated: February 6, 2026

On this page

ECG（心电图）

ECG 数据包括来自兼容 Apple 设备（如 Apple Watch Series 4 及更新机型）的心电图读数。ECG 数据提供详细的心律分析，可以检测心房颤动等状况。在 JSON 导出中，ECG 数据存储在 ecg 数组中。

结构

每个 ECG 条目包括分类结果、心率测量值、电压数据和采样信息：

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:30:30 -0800",
  "classification": "Sinus Rhythm",
  "severity": "Not Set",
  "averageHeartRate": 72,
  "numberOfVoltageMeasurements": 512,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

字段

必需字段

  • start (日期): ECG 读数的开始时间（格式：yyyy-MM-dd HH:mm:ss Z）
  • end (日期): ECG 读数的结束时间（格式：yyyy-MM-dd HH:mm:ss Z）
  • classification (字符串): 心律分类（见下方分类）
  • averageHeartRate (数字): ECG 读数期间的平均心率（每分钟心跳数，bpm）
  • numberOfVoltageMeasurements (数字): ECG 样本中的电压测量总数
  • voltageMeasurements (数组): 电压测量数组（见下方电压测量）
  • samplingFrequency (数字): 采样频率（Hz）（通常 Apple Watch 为 512 Hz）
  • source (字符串): 记录 ECG 的源设备或应用

可选字段

  • severity (字符串): ECG 结果的严重程度分类（如果不适用，可能为 "Not Set"）

ECG 分类

classification 字段表示检测到的心律：

  • "Sinus Rhythm" - 正常心律
  • "Atrial Fibrillation" - 检测到不规则心律（房颤）
  • "High Heart Rate" - 心率超出正常范围
  • "Inconclusive Low Heart Rate" - 由于心率过低无法分类
  • "Inconclusive High Heart Rate" - 由于心率过高无法分类
  • "Inconclusive" - 无法确定分类
  • "Inconclusive Poor Recording" - 由于信号质量差无法分类
  • "Unrecognized" - 分类未识别

电压测量

每个 ECG 条目包括一个电压测量数组，表示心脏随时间的电活动：

{
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    },
    {
      "date": "2024-02-06 14:30:00.002 -0800",
      "voltage": 0.125,
      "units": "V"
    }
  ]
}

电压测量字段：

  • date (日期): 电压测量的精确时间戳（包括毫秒）
  • voltage (数字): 电压值（单位：伏特）
  • units (字符串): 测量单位（通常伏特为 "V"）

注意： 电压测量以 samplingFrequency 指定的频率（通常为 512 Hz，即每秒 512 次测量）进行采样。

条目示例

正常窦性心律

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:30:30 -0800",
  "classification": "Sinus Rhythm",
  "severity": "Not Set",
  "averageHeartRate": 72,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

心房颤动检测

{
  "start": "2024-02-06 16:45:00 -0800",
  "end": "2024-02-06 16:45:30 -0800",
  "classification": "Atrial Fibrillation",
  "severity": "Not Set",
  "averageHeartRate": 95,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 16:45:00.000 -0800",
      "voltage": 0.145,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

不确定读数

{
  "start": "2024-02-06 18:00:00 -0800",
  "end": "2024-02-06 18:00:30 -0800",
  "classification": "Inconclusive Poor Recording",
  "severity": "Not Set",
  "averageHeartRate": 68,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 18:00:00.000 -0800",
      "voltage": 0.098,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

理解 ECG 数据

采样频率

samplingFrequency（通常为 512 Hz）表示每秒进行的电压测量次数。对于 30 秒的 ECG 读数：

  • 总测量数 = 512 × 30 = 15,360 次测量
  • 每次测量代表约 0.002 秒（2 毫秒）的心脏活动

电压测量

电压测量表示心脏的电活动：

  • 正值: 除极（心肌收缩）
  • 负值: 复极（心肌放松）
  • 模式分析: 电压随时间变化的模式表示心律

分类解释

  • 窦性心律: 正常、健康的心律
  • 心房颤动: 可能需要医疗关注的不规则心律
  • 不确定: 可能表示信号质量差、读数期间移动或其他因素
  • 高/低心率: 超出正常范围的心率，无法准确分类

设备兼容性

ECG 功能需要：

  • Apple Watch Series 4 或更新机型（带 ECG 应用）
  • 配对 iPhone 上 iOS 12.1.1 或更新版本
  • ECG 应用已安装并设置

使用场景

ECG 数据可用于：

  • 心律监测: 跟踪一段时间内的心律模式
  • 房颤检测: 监测心房颤动发作
  • 医疗记录: 与医疗提供者共享 ECG 数据
  • 趋势分析: 识别心律的模式或变化
  • 症状关联: 将 ECG 读数与症状或活动进行交叉引用

重要提示

  • 非医疗设备: Apple Watch ECG 不旨在替代专业医疗诊断
  • 咨询医疗提供者: 始终就 ECG 结果咨询医疗专业人员，特别是在检测到房颤时
  • 定期监测: 定期 ECG 读数有助于识别模式，但不应替代专业医疗护理
  • 文件大小: 包含完整电压测量的 ECG 导出可能由于高采样率而较大

提示

  • 一致读数: 在一致的时间进行 ECG 读数，以便更好地进行趋势分析
  • 正确放置: 确保读数期间正确放置手表并保持静止，以获得准确结果
  • 选择性导出: 导出 ECG 数据时考虑日期范围，因为包含完整电压测量的文件可能较大

相关文档