참고 자료

권장 설정

성공적인 방송을 위해서는 라이브 동영상을 다음과 같이 설정하는 것이 좋습니다.

오디오와 동영상 데이터를 모두 포함합니다.
8시간을 초과하지 않습니다.
아래와 같이 지정된 권장 설정을 활용합니다(예: H264/AAC 사용).
방송 중간에 설정을 변경하지 않습니다.

이 제한 사항을 준수하지 않으면 다음과 같은 문제가 발생할 수 있습니다.

갑작스러운 스트림 중단
시청자 측의 영상 화질 저하
예상치 못한 동작

동영상 설정

키 프레임 크기 — 2초를 권장합니다. 4초를 초과하지 않아야 합니다.
해상도 및 비트레이트 —
1080p @ 60FPS
해상도: 1920x1080
동영상 비트레이트 범위: 4,500-9,000Kbps
1080p @ 30FPS
해상도: 1920x1080
동영상 비트레이트 범위: 3,000-6,000Kbps
720p @ 60FPS
해상도: 1280x720
동영상 비트레이트 범위: 2,250-6,000Kbps
720p @ 30FPS
해상도: 1280x720
동영상 비트레이트 범위: 1,500-4,000Kbps
480p @ 30FPS
해상도: 854x480
동영상 비트레이트 범위: 600-2,000Kbps
360p
해상도: 640x360
동영상 비트레이트 범위: 400-1,000Kbps
프로토콜 — RTMPS 스트리밍
픽셀 가로세로비 — 16:9를 권장합니다. 이 비율과 지나치게 차이가 나면 스트리밍이 지원되지 않을 수 있습니다.
동영상 코덱 —
- 최대 1080p 30FPS - H.264, Level 4.1
- 1080p 60FPS - H.264, Level 4.2

오디오 설정

오디오 코덱 — AAC 저복잡도
샘플 레이트 — 44.1kHz 또는 48kHz
오디오 비트레이트 — 128kbps(권장)-256kbps(초과하지 말 것)
채널 레이아웃 — 스테레오

엔드포인트

LiveVideo

엔드포인트	설명
`DELETE /{live_video_id}`	LiveVideo를 삭제합니다.
`GET /{event-id}/live_videos`	이벤트에서 LiveVideos 컬렉션을 가져옵니다.
`GET /{group-id}/live_videos`	그룹에서 LiveVideos 컬렉션을 가져옵니다.
`GET /{live-video-id}`	LiveVideo에서 필드와 에지를 가져옵니다.
`GET /{live-video-id}/comments`	LiveVideo에서 댓글 컬렉션을 가져옵니다.
`GET /{live-video-id}/crosspost_shared_pages`	LiveVideo를 공유할 수 있는 페이지 컬렉션을 가져옵니다.
`GET /{live-video-id}/likes`	LiveVideo에 좋아요를 누른 프로필 컬렉션을 가져옵니다.
`GET /{live-video-id}/polls`	LiveVideo에서 VideoPolls 컬렉션을 가져옵니다.
`GET /{live-video-id}/reactions`	LiveVideo에 공감을 보인 프로필 컬렉션을 가져옵니다.
`GET /{page-id}/live_videos`	페이지에서 LiveVideos 컬렉션을 가져옵니다.
`GET /{user-id}/live_videos`	사용자로부터 LiveVideos 컬렉션을 가져옵니다.
`POST /{event-id}/live_videos`	이벤트에서 LiveVideo를 생성합니다.
`POST /{group-id}/live_videos`	그룹에서 LiveVideo를 생성합니다.
`POST /{live_video_id}`	LiveVideo에 대한 필드를 업데이트합니다.
`POST /{live_video_id}/input_streams`	LiveVideo에서 LiveVideoInputStream을 생성합니다.
`POST /{live_video_id}/polls`	LiveVideo에 대한 VideoPoll을 생성합니다.
`POST /{page-id}/live_videos`	페이지에서 LiveVideo를 생성합니다.
`POST /{user-id}/live_videos`	사용자에 대한 LiveVideo를 생성합니다.

LiveVideoInputStream

엔드포인트	설명
`GET /{live-video-input-stream-id}`	LiveVideoInputStream에서 필드와 에지를 가져옵니다.
`POST /{live_video_id}/input_streams`	LiveVideo에서 LiveVideoInputStream을 생성합니다.

설문

엔드포인트	설명
`GET /{live-video-id}/polls`	LiveVideo에서 VideoPolls 컬렉션을 가져옵니다.
`GET /{video-poll-id}`	VideoPoll에서 필드와 에지를 가져옵니다.
`POST /{live_video_id}/polls`	LiveVideo에 대한 VideoPoll을 생성합니다.
`POST /{video_poll_id}`	VideoPoll에 대한 필드를 업데이트합니다.

오류 코드

오류 메시지는 RTMP를 통해 전송된 다음, 이어서 그래프 API로 전달됩니다. 방송/동영상 ID를 사용하여 GET 요청을 통해 그래프 탐색기 도구에서 오류에 대해 쿼리할 수 있습니다. 반환된 오류에는 오류 코드, 설명, 타임스탬프가 포함됩니다.

error_subcode	오류 요약	설명
`COPYRIGHT__LIVE_COPYRIGHT_VIOLATION`	라이브 저작권 위반	다른 페이지에 속한 오디오 또는 영상 콘텐츠를 포함할 수 있으므로 라이브 방송이 중단되었습니다.
`VIDEO__CREATE_FAILED`	업로드 문제	문제가 발생하여 동영상이 업로드되지 않았습니다. 다시 시도해보세요.
`LIVE_VIDEO__DELETE_FAILED`	라이브 방송이 삭제되지 않음	문제가 발생하여 라이브 방송을 삭제하지 못했습니다. 다시 시도해보세요.
`LIVE_VIDEO__EDIT_API_NOT_ALLOWED`	라이브 방송 중에 동영상 API로 수정할 수 없음	라이브 방송은 동영상 수정 API로 수정할 수 없습니다. 라이브 방송 ID를 사용하세요.
`LIVE_VIDEO__LIVE_STREAM_ERROR`	일반 스트리밍	스트리밍 중 오류가 발생했습니다.
`LIVE_VIDEO__NOT_EXIST`	라이브 방송이 존재하지 않음	현재 액세스하려는 라이브 방송이 시스템에 더 이상 존재하지 않습니다.
`LIVE_VIDEO__PRIVACY_REQUIRED`	공개 범위 설정 필요	방송을 시작하기 전에 공개 범위를 설정해야 합니다.