HealthyApps Help Center

Thông báo nhịp tim - Định dạng xuất JSON

Tài liệu về cấu trúc thông báo nhịp tim trong các lần xuất JSON

Last updated: March 31, 2026

Trên trang này

Thông báo nhịp tim

Thông báo nhịp tim bao gồm cảnh báo nhịp tim cao và thấp từ Apple Watch, thông báo nhịp không đều, và dữ liệu nhịp tim chi tiết được thu thập trong các sự kiện này. Trong bản xuất JSON, thông báo nhịp tim được lưu trong mảng heartRateNotifications.

Cấu trúc

Dữ liệu thông báo nhịp tim có cấu trúc riêng, khác với các chỉ số sức khỏe khác. Mỗi thông báo gồm thời điểm sự kiện, ngưỡng (đối với thông báo cao/thấp), và các đo nhịp tim chi tiết trong sự kiện:

{
  "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"
        }
      }
    }
  ]
}

Trường

Trường bắt buộc

  • start (Ngày/giờ): Thời điểm bắt đầu sự kiện thông báo nhịp tim, định dạng yyyy-MM-dd HH:mm:ss Z
  • end (Ngày/giờ): Thời điểm kết thúc sự kiện thông báo nhịp tim, định dạng yyyy-MM-dd HH:mm:ss Z
  • heartRate (Mảng): Mảng các lần đo nhịp tim trong sự kiện (xem mục Dữ liệu nhịp tim bên dưới)
  • heartRateVariation (Mảng): Mảng các lần đo biến thiên nhịp tim (HRV) trong sự kiện (xem mục Dữ liệu HRV bên dưới)

Trường tùy chọn

  • threshold (Số): Ngưỡng nhịp tim kích hoạt thông báo. Chỉ có trong thông báo nhịp tim cao và thấp.

Loại thông báo

Thông báo nhịp tim cao

Kích hoạt khi nhịp tim vượt ngưỡng đặt (thường 100–150 nhịp/phút) trong lúc nghỉ.

{
  "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": []
}

Thông báo nhịp tim thấp

Kích hoạt khi nhịp tim xuống dưới ngưỡng đặt (thường 40–50 nhịp/phút) trong lúc nghỉ.

{
  "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": []
}

Thông báo nhịp không đều

Kích hoạt khi Apple Watch phát hiện nhịp không đều có thể gợi ý rung nhĩ.

{
  "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"
        }
      }
    }
  ]
}

Lưu ý: Thông báo nhịp không đều không có trường threshold.

Dữ liệu nhịp tim

Mảng heartRate chứa các lần đo nhịp tim chi tiết trong sự kiện thông báo:

{
  "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"
    }
  }
}

Trường:

  • hr (Số): Giá trị nhịp tim, đơn vị nhịp mỗi phút
  • units (Chuỗi): Đơn vị đo (luôn là "bpm" cho nhịp mỗi phút)
  • timestamp (Đối tượng): Khoảng thời gian của lần đo này
    • start (Ngày/giờ): Bắt đầu khoảng đo
    • end (Ngày/giờ): Kết thúc khoảng đo
    • interval (Đối tượng): Độ dài khoảng đo
      • duration (Số): Giá trị độ dài
      • units (Chuỗi): Đơn vị (luôn là "s" cho giây)

Dữ liệu biến thiên nhịp tim (HRV)

Mảng heartRateVariation chứa các lần đo biến thiên nhịp tim:

{
  "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"
    }
  }
}

Trường:

  • hrv (Số): Giá trị biến thiên nhịp tim, đơn vị mili giây
  • units (Chuỗi): Đơn vị đo (luôn là "ms" cho mili giây)
  • timestamp (Đối tượng): Cấu trúc giống mốc thời gian của nhịp tim

Hiểu về HRV:

  • HRV đo sự thay đổi khoảng thời gian giữa các nhịp tim
  • HRV cao hơn thường gợi ý thể lực tim mạch và phục hồi căng thẳng tốt hơn
  • HRV thấp hơn có thể gợi ý căng thẳng, mệt mỏi hoặc vấn đề sức khỏe
  • HRV có thể thay đổi nhiều tùy thời điểm trong ngày, mức hoạt động và đặc điểm cá nhân

Ví dụ: Một mục thông báo đầy đủ

{
  "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"
        }
      }
    }
  ]
}

Ngưỡng thông báo

Ngưỡng do người dùng cấu hình trong Cài đặt Apple Health:

  • Nhịp tim cao: Thường 100–150 nhịp/phút (mặc định thay đổi theo tuổi)
  • Nhịp tim thấp: Thường 40–50 nhịp/phút (mặc định thay đổi theo tuổi)

Trường threshold cho biết đúng ngưỡng đã kích hoạt thông báo.

Yêu cầu thiết bị

Thông báo nhịp tim cần:

  • Apple Watch Series 1 trở lên (đo nhịp tim cơ bản)
  • Apple Watch Series 4 trở lên (thông báo nhịp không đều)
  • watchOS 5.1.2 trở lên (thông báo nhịp không đều)
  • Đã bật thông báo trong Cài đặt Apple Health

Trường hợp sử dụng

Dữ liệu thông báo nhịp tim hữu ích để:

  • Theo dõi sức khỏe: Biết khi nào nhịp tim vượt phạm vi bình thường
  • Phát hiện rung nhĩ: Theo dõi thông báo nhịp không đều để nghi ngờ rung nhĩ
  • Hồ sơ y tế: Chia sẻ sự kiện thông báo với nhà cung cấp dịch vụ y tế
  • Phân tích quy luật: Nhận diện yếu tố kích hoạt hoặc mô hình sự kiện nhịp tim
  • Thông tin thể lực: Hiểu phục hồi và phản ứng căng thẳng qua dữ liệu HRV
  • Liên hệ với triệu chứng: Đối chiếu thông báo với triệu chứng, hoạt động hoặc thuốc

Lưu ý quan trọng

  • Không phải thiết bị y tế: Thông báo trên Apple Watch không thay thế chẩn đoán y khoa chuyên nghiệp
  • Tham vấn nhân viên y tế: Luôn thảo luận với chuyên gia y tế về thông báo nhịp tim, đặc biệt là cảnh báo nhịp không đều
  • Bối cảnh quan trọng: Nhịp tim có thể tăng do tập luyện, căng thẳng, caffeine, thuốc hoặc yếu tố khác
  • Thông báo rung nhĩ: Thông báo nhịp không đều có thể gợi ý rung nhĩ và nên được thảo luận với nhân viên y tế

Mẹo

  • Xem lại thông báo: Thường xuyên xem thông báo nhịp tim để nhận ra quy luật
  • Ghi nhớ bối cảnh: Cân nhắc bạn đang làm gì khi có thông báo (tập, căng thẳng, ngủ, v.v.)
  • Theo dõi xu hướng: Theo dõi tần suất và quy luật thông báo theo thời gian
  • Kết hợp với ECG: Đối chiếu thông báo nhịp không đều với kết quả ECG để theo dõi tim toàn diện hơn

Tài liệu liên quan