Начало работы

В этом документе описано, как использовать Live Video API проведения прямых видеотрансляций с помощью вашего приложения. Если у вас нет приложения, используйте Graph API Explorer и программу для трансляций на свое усмотрение.

Прежде чем начать

Если у вас есть приложение, вам понадобятся:

• ID приложения Meta со сценарием использования входа через Facebook ;
• реализованный в вашем приложении вход через Facebook

  • если ваше приложение находится на устройстве, интерфейс которого не позволяет войти в Facebook, используйте вход через Facebook для устройств ;
• следующие разрешения: publish_video ;
• маркер доступа .

Если у вас нет приложения, вам также понадобятся:

• Graph API Explorer ;
• программное обеспечение для видеотрансляции.

Запуск трансляции

Чтобы создать объект LiveVideo, отправьте запрос POST к конечной точке /me/live_videos?status=LIVE_NOW (где 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 — это ID объекта LiveVideo, который можно использовать для управления трансляцией. Значение secure_stream_url — это URL входящих данных, через который вы будете отправлять данные трансляции от кодировщика объекту LiveVideo.

Отправка данных трансляции

Передайте полученное на предыдущем шаге значение secure_stream_url кодировщику и начните отправлять на него данные трансляции. Как только объект LiveVideo обнаружит данные трансляции, она появится в вашем профиле пользователя.

Перейдите к своему профилю и убедитесь, что новая видеопубликация, содержащая вашу трансляцию, создана.

Если для трансляции используется стороннее программное обеспечение, а не собственное приложение, добавьте значение secure_stream_url вручную. В зависимости от используемого программного обеспечения значение URL может потребоваться разбить на компоненты сервера (rtmps://rtmp-api.facebook.com/rtmp/) и ключа (все после /rtmp/).

Завершение трансляции

Чтобы завершить трансляцию, отправьте запрос POST к конечной точке /<LIVE_VIDEO_ID>?end_live_video=true.

Пример запроса на завершение трансляции

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

Трансляция завершится и будет сохранена как видео по запросу (VOD). Если вы хотите удалить VOD, отправьте запрос к конечной точке DELETE /<LIVE_VIDEO_ID>.

Коды ошибок отказа в разрешении

Дальнейшие действия

• Используйте Live Video API, чтобы запланировать прямой эфир для будущей трансляции.