4.방송 송출 시작
녹화 방송 타입으로 녹화한 방송을 라이브 방송처럼 송출한다. 라이브 방송이 정상적으로 시작되면 등록된 콜백 URL로 방송 시작 콜백, 방송 업데이트 콜백, 방송 종료 콜백을 받을 수 있다.
HTTP 요청
POST /api/2/applications/{app_key}/videos/{video_key}/broadcast
경로 변수
| 키 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| app_key | string | true | 애플리케이션의 키 |
| video_key | string | true | 비디오의 키 |
요청 본문
없음
응답 본문
방송 객체
| 키 | 타입 | 설명 |
|---|---|---|
| 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 | (방송 종료시 포함) 방송 통계 객체 |
요청 예
| 키 | 설명 |
|---|---|
| POST | https://api.flipflop.tv/api/2/applications/SAMPLE_APP/videos/100000/broadcast |
| Header | Authorization: Bearer {access_token} Content-Type: application/json; charset=utf-8 Accept: application/json |
응답 예
| Http Status | 설명 |
|---|---|
| 200 | {"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} |
| 400 | {"code": 40000, "message": "Invalid user_id: valid value of 'user_id' is range 1 to 80."} |