🔔 Thông báo cho Live

Mô tả: Đây là định nghĩa các thông báo sẽ được gửi khi có các sự kiện đặc biệt xảy ra trong quá trình transcoding (chuyển mã) của live event hoặc linear live.

---

1. Sự kiện Thông báo (Notification Event)

Sự kiện (Event)	Dữ liệu trong body (Available_Body_Data)	Mô tả
STREAMING_PUBLISH	--	--
STREAMING_UNPUBLISH	status_desc	Mô tả trạng thái: "close" (đóng) hoặc "timeout" (hết thời gian)
RECORD_FILE_GENERATED	dvr_url	Ví dụ: http://example/vod.m3u8
	dvr_duration	Thời lượng của DVR VOD
RECORD_FILE_ERROR	err_msg	Lý do lỗi (error message)

---

2. Cấu trúc thông báo (Notification Structure)

{
    "event": "{sự kiện}",
    "domain": "__defaultVhost__",
    "app": "{tên ứng dụng}",
    "stream": "{tên luồng}",
    "body": {
       Nội dung khác nhau tùy theo sự kiện
    },
    "notification_time": {timestamp dạng UNIX}
}

---

3. Mẫu thông báo cho từng sự kiện cụ thể

3.1 STREAMING_PUBLISH – Khi luồng bắt đầu được phát

{
    "event": "STREAMING_PUBLISH",
    "domain": "__defaultVhost__",
    "app": "{tên ứng dụng}",
    "stream": "{tên luồng}",
    "notification_time": {timestamp}
}

---

3.2 STREAMING_UNPUBLISH – Khi luồng kết thúc

{
    "event": "STREAMING_UNPUBLISH",
    "domain": "__defaultVhost__",
    "app": "{tên ứng dụng}",
    "stream": "{tên luồng}",
    "body": {
        "status_desc": "close"
    },
    "notification_time": {timestamp}
}

Ghi chú: status_desc có thể là "close" (người phát dừng chủ động) hoặc "timeout" (mất kết nối hoặc ngắt bất ngờ).

---

3.3 RECORD_FILE_GENERATED – Khi DVR (ghi hình) được tạo thành công

{
    "event": "RECORD_FILE_GENERATED",
    "domain": "__defaultVhost__",
    "app": "{tên ứng dụng}",
    "stream": "{tên luồng}",
    "body": {
        "dvr_index_file_id": "{ID chỉ mục của file DVR}",
        "dvr_duration": {thời lượng của file DVR},
        "dvr_url": "{URL của file manifest M3U8 chứa tất cả bản ghi DVR của luồng này}"
    },
    "notification_time": {timestamp}
}

---

3.4 RECORD_FILE_ERROR – Khi ghi hình DVR gặp lỗi

{
    "event": "RECORD_FILE_ERROR",
    "domain": "__defaultVhost__",
    "app": "{tên ứng dụng}",
    "stream": "{tên luồng}",
    "body": {
        "dvr_index_file_id": "{ID chỉ mục của file DVR}",
        "err_msg": "{thông báo lỗi}"
    },
    "notification_time": {timestamp}
}