Слайд-шоу

С помощью API Video на Страницах и в группах можно публиковать видео в формате слайд-шоу. Их публикация для пользователей не поддерживается. В примерах в этом документе используется узел Страницы, однако они в равной степени относятся и к узлам групп.

Создание слайд-шоу

Отправьте запрос POST к границе контекста Page Videos и включите в него объект, содержащий массив URL изображений, из которых требуется сформировать видео. Изображения должны храниться на общедоступном сервере. Объект должен описывать длительность демонстрации каждого изображения и продолжительность переходов между ними.

Форматы изображений

JPG, JPEG, PNG, BMP, ICO

Размеры изображений

Если у изображений разные размеры, API обрежет их до формата 600 × 600 пикселей и создаст квадратное видео. Если у всех изображений одинаковый размер, он используется и для видео.

Требования

  • Минимальное число изображений в запросе — 3, максимальное — 7.
  • Размер каждого файла изображения не должен превышать 10 МБ.

Синтаксис запроса

POST /v19.0/{page-id}/videos ?access_token={access-token} &slideshow_spec={slideshow-spec}

Обязательные параметры

Параметр Описание

access_token

Маркер доступа к Странице при публикации на Странице или маркер доступа пользователя при публикации в группе.

slideshow_spec

Объект, содержащий массив URL изображений и свойства, которые описывают видео. См. раздел Свойства объекта слайд-шоу ниже.

Свойства объекта слайд-шоу

Свойство Описание

images_urls
Обязательное

Массив, содержащий от 3 до 7 URL изображений, из которых будет сформировано видео.

duration_ms

Целое число, продолжительность (в миллисекундах) демонстрации каждого изображения в видео. Значение по умолчанию — 1750. Значение должно быть больше 0.

transition_ms

Целое число, продолжительность (в миллисекундах) перехода одного изображения в другое. Значение по умолчанию — 250. Значение должно быть больше 0.

Пример запроса

curl -X POST \ "https://graph-video.facebook.com/v19.0/1755847768034402/videos" \ -F "access_token=EAADd..." \ -F "slideshow_spec={ \ "images_urls":[ \ 'https://socialsizz...1.png', \ 'https://socialsizz...2.png', \ 'https://socialsizz...3.png' \ ], \ "duration_ms": 5000, \ "transition_ms": 200 \ }"

В случае успеха API вернет ID созданного видео.

Пример ответа JSON

{ "id":"277487313407856" }