Presentaciones

La API de video te permite publicar videos de presentación en páginas y grupos. No se admite la publicación en usuarios. En los ejemplos de este documento, se usa un nodo de página, pero también puedes usar nodos de grupo de la misma forma.

Crear una presentación

Envía una solicitud POST al punto de conexión de videos de la página e incluye un objeto que contenga una matriz de URL de imagen que se usará para construir el video. Las imágenes se deben alojar en un servidor de acceso público. El objeto debe describir cuánto tiempo se mostrará cada imagen y la duración de la transición entre las imágenes.

Formatos de imagen

JPG, JPEG, PNG, BMP, ICO

Dimensiones de imagen

Si las imágenes tienen diferentes dimensiones, la API las recortará, cambiará el tamaño a 600 x 600 píxeles y creará un video cuadrado. Si todas las imágenes tienen la misma dimensión, el video coincidirá con esa dimensión.

Requisitos

  • La solicitud debe incluir un mínimo de tres imágenes y un máximo de siete.
  • Cada imagen debe tener 10 MB o menos.

Sintaxis de la solicitud

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

Parámetros obligatorios

Parámetro Descripción

access_token

Token de acceso a la página si se publica en una página, o token de acceso de usuario si se publica en un grupo.

slideshow_spec

Objeto que contiene una matriz de propiedades y URL de imágenes que describen el video. Consulta Propiedades de los objetos de una presentación a continuación.

Propiedades de los objetos de una presentación

Propiedad Descripción

images_urls
(obligatoria)

Matriz que contiene de tres a siete URL de imágenes que se utilizarán en la construcción del video.

duration_ms

Número entero que indica la duración en milisegundos con la que debe mostrarse cada imagen en el video. El valor predeterminado es 1750. El valor debe ser mayor que 0.

transition_ms

Número entero que indica la duración en milisegundos de la transición de encadenado entre imágenes. El valor predeterminado es 250. El valor debe ser mayor que 0.

Ejemplo de solicitud

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 \
   }"

Si la solicitud es correcta, la API responderá con el identificador del video recién construido.

Ejemplo de respuesta JSON

{
  "id":"277487313407856"
}