Обзор
В API Graph прямые видеотрансляции представлены в виде объектов LiveVideo. Чтобы начать прямую трансляцию, сначала нужно создать объект LiveVideo для пользователя, Страницы, группы или Мероприятия. После создания объекта LiveVideo API вернет его ID и URL входящих данных трансляции. С помощью URL вы сможете отправлять данные трансляции от кодировщика объекту LiveVideo, а с помощью объекта — управлять видимостью трансляции.
Компоненты
Трансляции
Прямые видеотрансляции представлены в виде объектов LiveVideo. Через свойства объекта LiveVideo можно управлять самой трансляцией. Например, можно изменять уровень доступности трансляции, ее описание и название, добавлять метки, определять аудитории, добавлять опросы и многое другое.
Объекты LiveVideo связаны с объектами LiveVideoInputStream, которые представляют входящие данные трансляции. Объекты LiveVideoInputStream создаются и управляются автоматически.
Трансляции можно создавать для объектов User, Page, Group и Event. Для этого используется их граница контекста /live_videos.
URL трансляции
URL трансляции — это URL входящих данных, с помощью которого можно отправлять данные трансляции от кодировщика объекту LiveVideo. При создании объекта LiveVideo через API в ответе API будет содержаться ID объекта LiveVideo и уникальный URL трансляции. Его нужно использовать в течение 24 часов, после чего срок действия URL истечет. После первичного использования на этот URL можно отправлять данные трансляции в течение восьми часов.
Протоколы входящих данных
API Live Video поддерживает протокол RTMPS.
RTMPS
Данные трансляции, отправляемые на URL трансляции, должны быть зашифрованы с использованием протокола передачи данных RTMPS. При создании объекта LiveVideo API возвращает безопасный URL RTMPS, который нужно использовать для трансляции через серверы Facebook.
Вот несколько примеров поставщиков программного и аппаратного обеспечения, которые поддерживают RTMPS:
|
|
|
|
Видеотрансляции Страниц и Workplace могут использовать стандартный незашифрованный протокол RTMP до 1 ноября 2019 г., после чего поддержка протокола RTMP будет прекращена. В начале прямой трансляции API возвращает URL RTMP, который можно использовать для проведения незашифрованной трансляции через серверы Facebook. Обратите внимание: если вы используете RTMP и постоянный ключ трансляции, вам придется сбросить постоянный ключ и обновить его на всех устройствах, на которых он применяется, иначе ваши трансляции не будут запускаться.
Опросы
С помощью API можно создавать опросы в прямых видеотрансляциях и получать ответы зрителей в режиме реального времени. В API Graph опросы представлены объектами VideoPoll. Их можно создавать с использованием конечной точки POST /{live-video-id}/polls объектов LiveVideo. После создания опроса API возвращает ID объекта VideoPoll, с помощью которого можно управлять опросом и запрашивать взаимодействия зрителей.
Инструменты
Live Video Composer
Если вы используете программное обеспечение для трансляции, которое не может работать с API Live Video, для получения URL трансляции и указания его вручную (например, в OBS, XSplit и т. д.) можно использовать инструмент Live Video Composer. Live Video Composer позволяет создавать трансляции в вашем профиле пользователя, на Страницах, в группах и Мероприятиях, которыми вы управляете.
Live Video ComposerLive Ingests
Качество вашей трансляции зависит от стабильности подключения к нашим серверам. Если ваше подключение нестабильно, видео может иметь низкое качество, могут возникать ошибки воспроизведения или же обрывы трансляции. Инструмент Live Ingests позволяет протестировать качество отправки вашей трансляции и выявить проблемы с подключением, определить наилучший сервер для отправки трансляции и снизить количество ошибок и проблем.
Live IngestsСпецификации видео
Полный список спецификаций видео и аудио можно найти в этом разделе.