3.방송 종료 콜백
- 라이브 방송이 종료되면 등록된 콜백 주소로 아래의 콜백 정보를 보낸다.
- 방송이 종료되면 파일 다운로드 URL이 및 통계 관련 정보들이 포함된다. 누적 시청자 수 추이 간격은 기본이 10분이고, 최소 1분 단위로 요청이 가능하다.
- state가 VOD이면 정상 종료이고, TERMINATED이면 방송이 끊어지거나 서버에 의해 비정상적으로 종료된 경우에 해당한다.
요청 본문
콜백 객체
| 키 | 타입 | 설명 |
|---|---|---|
| callback_type | string | 콜백 타입 - END |
| video | object | 방송 객체 |
방송 객체
| 키 | 타입 | 설명 |
|---|---|---|
| video_key | string | 방송 키 |
| state | string | 방송 상태. LIVE 또는 VOD |
| url | string | 방송 URL |
| thumbnail_url | string | 방송 썸네일 URL |
| duration | long | 방송 길이(millisecond) |
| watch_count | long | LIVE 시청자 수 |
| heart_count | long | 하트 수 |
| view_count | long | 조회 수 |
| like_count | long | 좋아요 수 |
| video_download_url | long | (라이브가 끝난 경우에만 해당) 비디오 파일 |
| chat_download_url | string | (라이브가 끝난 경우에만 해당) 채팅 메시지 파일 |
| preview_url | string | 하이라이트 URL |
| preview_duration | long | 하이라이트 길이(millisecond) |
| started_at | long | 방송 시간 시간 (unix timestamp, millisecond) |
| ended_at | long | 방송 종료 시간 (unix timestamp, millisecond) |
| recorded_at | long | 녹화 시작 시간 (unix timestamp, millisecond) |
| stats | object | (방송 종료시 포함) 방송 통계 객체 |
방송 통계 객체
| 키 | 타입 | 설명 |
|---|---|---|
| total_watcher_count | long | 누적 시청자 수 |
| live_watcher_count | long | 라이브 시청자 수 |
| max_watcher_count | long | 최대 시청자 수 |
| total_message_count | long | 전체 채팅 메시지 개수 |
| like_count | long | 좋아요 수 |
| heart_count | long | 하트 수 |
| avg_live_watch_time | long | 평균 시청 시간 (초) |
| total_watcher_trend | Array | 누적 시청자 추이 객체 Array |
| vod | Object | VOD 시청 통계. 기본 통계 객체 |
| preview | Object | Preview 시청 통계. 기본 통계 객체 |
기본 통계 객체
| 키 | 타입 | 설명 |
|---|---|---|
| view_count | long | 조회 수 |
| avg_watch_count | long | 평균 시청 시간 (초) |
누적 시청자 추이 객체
| 키 | 타입 | 설명 |
|---|---|---|
| time | long | 방송 시작 후 시간 (분) |
| total_watcher_count | long | 누적 시청자 수 |
요청 예
| 키 | 설명 |
|---|---|
| POST | { your_callaback_url } |
| Payload | {“callback_type”: END, “video”: {"video_key": "a10000", "url": "{broadcast_host_url}/10000/index.m3u8", "thumbnail_url": "{thumbnail_host_url}/videos/10000/thumbnail.jpg?time=1619480079775", "state": "LIVE", "heart_count": 0, "watch_count": 0, "max_watch_count": 0, "view_count": 0, "like_count": 0, "video_download_url": "{broadcast_host_url}/videos/10000/vod.mp4?time=1619480079775", "chat_download_url": "{broadcast_host_url}/sample_app/videos/100000/chat.csv", “stats”:{ “...”: "..."}}} |