API Live Video
Сменить язык обратно на Русский
Этот документ обновлен.
Перевод (Русский) еще не готов.
Последнее обновление (английский): 15 дек 2021 г.

Справка

Рекомендации по настройке

Для успешного проведения трансляции соблюдайте следующие требования:

  • Трансляция должна содержать как аудио-, так и видеоданные.
  • Длительность не должна превышать восемь часов.
  • Должны использоваться рекомендации по настройке, описанные ниже (например, стандарт сжатия видео H264, стандарт сжатия аудио AAC).
  • Настройки не должны меняться в ходе трансляции.

В случае несоблюдения указанных выше требований пользователи могут столкнуться с такими проблемами, как:

  • неожиданное прекращение трансляции;
  • ухудшение качества трансляции для зрителей;
  • другие непредсказуемые отклонения.

Настройки видео

  • Рекомендуемый интервал для ключевых кадров: 2 секунды. Максимальный — 4 секунды.

  • Разрешение и скорость передачи видео

    1080p при частоте 60 кадров/с
    Разрешение: 1920 × 1080
    Скорость передачи видео: 4500–9000 Кбит/с

    1080p при частоте 30 кадров/с
    Разрешение: 1920 × 1080
    Скорость передачи видео: 3000–6000 Кбит/с

    720p при частоте 60 кадров/с
    Разрешение: 1280 × 720
    Скорость передачи видео: 2250–6000 Кбит/с

    720p при частоте 30 кадров/с
    Разрешение: 1280 × 720
    Скорость передачи видео: 1500–4000 Кбит/с

    480p при частоте 30 кадров/с
    Разрешение: 854 × 480
    Скорость передачи видео: 600–2000 Кбит/с

    360p
    Разрешение: 640 × 360
    Скорость передачи видео: 400–1000 Кбит/с

  • Протокол трансляции: RTMPS
  • Соотношение сторон: старайтесь соблюдать соотношение 16:9. В противном случае может быть невозможно поддерживать вашу трансляцию.
  • Видеокодек:
    • H.264 уровня 4.1 для разрешения до 1080p при частоте 30 кадров/с;
    • H.264 уровня 4.2 для разрешения 1080p при частоте 60 кадров/с.

Настройки аудио

  • Аудиокодек: AAC (профиль Low Complexity)
  • Частота дискретизации: 44,1 КГц или 48 КГц
  • Скорость передачи аудио: от 128 Кбит/с (рекомендуется) до 256 Кбит/с (не превышать)
  • Тип канала: стерео

Конечные точки

LiveVideo

Конечная точкаОписание

DELETE /{live_video_id}

Удаление LiveVideo.

GET /{event-id}/live_videos

Получение подборки объектов LiveVideo для события.

GET /{group-id}/live_videos

Получение подборки объектов LiveVideo для группы.

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

Получение подборки объектов VideoPoll для этого объекта LiveVideo.

GET /{live-video-id}/reactions

Получение подборки профилей, которые отреагировали на этот объект LiveVideo.

GET /{page-id}/live_videos

Получение подборки объектов LiveVideo для Страницы.

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

Создание LiveVideoInputStream для этого объекта LiveVideo.

POST /{live_video_id}/polls

Создание VideoPoll для LiveVideo.

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

Создание LiveVideoInputStream для этого объекта LiveVideo.

Опросы

Конечная точкаОписание

GET /{live-video-id}/polls

Получение подборки объектов VideoPoll для этого объекта LiveVideo.

GET /{video-poll-id}

Получение полей и границ контекста для VideoPoll.

POST /{live_video_id}/polls

Создание VideoPoll для этого объекта LiveVideo.

POST /{video_poll_id}

Обновление полей VideoPoll.

Коды ошибок

Сообщения об ошибках отправляются через RTMP, сохраняются и остаются доступными через API Graph. Вы можете с помощью ID трансляции/видео запросить ошибки в инструменте Graph Explorer с помощью запроса GET. Возвращаемые ошибки содержат код, описание и метку времени.

error_subcodeОшибкаОписание
COPYRIGHT__LIVE_COPYRIGHT_VIOLATION

Нарушение авторских прав в трансляции

Ваша видеотрансляция остановлена, так как она, вероятно, содержит аудио- или визуальный контент, принадлежащий другой Странице.

VIDEO__CREATE_FAILED

Ошибка при загрузке

При загрузке произошла ошибка, видео не загружено. Повторите попытку.

LIVE_VIDEO__DELETE_FAILED

Видеотрансляция не удалена

Произошла ошибка, ваша видеотрансляция не удалена. Повторите попытку.

LIVE_VIDEO__EDIT_API_NOT_ALLOWED

Редактирование через API Video во время трансляции невозможно

Видеотрансляции нельзя редактировать через API Video Edit. Используйте для этого ID трансляции.

LIVE_VIDEO__LIVE_STREAM_ERROR

Общая ошибка

При трансляции произошла ошибка.

LIVE_VIDEO__NOT_EXIST

Видеотрансляция не существует

Трансляция, которую вы пытаетесь открыть, больше не существует в системе.

LIVE_VIDEO__PRIVACY_REQUIRED

Необходимо настроить конфиденциальность

Перед проведением трансляции необходимо задать настройки конфиденциальности.