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 資料時考慮日期範圍，因為包含完整電壓測量的檔案可能較大

相關文件