시작하기

이 문서에서는 라이브 방송 API를 사용하여 앱으로 라이브 방송을 내보내는 방법을 설명합니다. 앱이 없는 경우 그래프 API 탐색기와 원하는 스트리밍 소프트웨어를 사용할 수 있습니다.

시작하기 전에

앱이 있는 경우 다음이 필요합니다.

• Facebook 로그인 사용 사례가 적용된 Meta 앱 ID
• 앱에 구현된 Facebook 로그인

  • 사용자가 Facebook에 로그인하도록 허용하는 인터페이스가 없는 기기에서 앱을 사용하는 경우, 대신 기기용 Facebook 로그인 을 구현하세요.
• 다음 권한: publish_video
• 액세스 토큰

앱이 없는 경우 다음 항목도 준비해야 합니다.

• 그래프 API 탐색기
• 동영상 스트리밍 소프트웨어

방송 시작

라이브 방송 개체를 만들려면 /me/live_videos?status=LIVE_NOW 엔드포인트로 POST 요청을 보내세요. 이때 me는 사용자 또는 페이지의 ID입니다.

curl -i -X POST \
 "https://graph.facebook.com/v21.0/me/live_videos?status=LIVE_NOW"

그러면 다음과 같은 응답이 반환됩니다.

{ 
  "id": "10214937378883406",  //The LiveVideo object ID
  "stream_url": "rtmp://rtmp-api.faceboo...",
  "secure_stream_url": "rtmps://rtmp-api.faceboo...", //The stream URL
  "stream_secondary_urls": [],
  "secure_stream_secondary_urls": []
}

반환된 id와 secure_stream_url 값을 캡처하세요. id는 LiveVideo 개체 ID이며 방송을 조정하는 데 사용할 수 있습니다. secure_stream_url은 인코더에서 LiveVideo 개체로 라이브 방송 데이터를 스트리밍하는 데 사용하는 수집 URL입니다.

방송 스트리밍

이전 단계에서 캡처한 secure_stream_url 값을 인코딩 기기에 전달하고, 여기에 라이브 방송 데이터를 스트리밍합니다. LiveVideo 개체가 스트리밍 데이터를 탐지하면 사용자 프로필에서 라이브 방송이 시작됩니다.

자신의 프로필을 보고 새로운 라이브 방송 게시물이 생성되어 스트리밍 데이터를 방송하고 있는지 확인합니다.

직접 앱을 개발하지 않고 스트리밍 소프트웨어를 사용하고 있다면 secure_stream_url 값을 소프트웨어에 수동으로 추가하세요. 사용 중인 스트리밍 소프트웨어에 따라 스트림 URL을 서버 부분(rtmps://rtmp-api.facebook.com/rtmp/)과 키 구성 요소 부분(/rtmp/ 이후의 모든 내용)으로 나누어야 할 수도 있습니다.

방송 종료

방송을 종료하려면 /<LIVE_VIDEO_ID>?end_live_video=true 엔드포인트로 POST 요청을 보내세요.

방송 종료 요청 예시

curl -i -X POST \
  "https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?end_live_video=true"

그러면 방송이 종료되고 VOD(Video On Demand)로 저장됩니다. VOD를 삭제하고자 하는 경우 DELETE /<LIVE_VIDEO_ID> 엔드포인트로 요청을 보내세요.

권한 거부 오류 코드

다음 단계

• 라이브 방송 API를 사용하여 향후 방송을 위한 라이브 동영상을 예약하세요.