幻灯片

借助视频 API,您可以在主页小组上发布幻灯片视频。不支持向用户发布幻灯片视频。本文档中的示例使用主页节点,但这些示例同样适用于小组节点。

创建幻灯片

主页视频连线发送 POST 请求,并添加包含一组图像网址的对象,用于构建视频。图像必须托管在可公开访问的服务器上。该对象应说明每张图像的显示时长以及图像间切换的时长。

图像格式

JPG、JPEG、PNG、BMP 和 ICO

图像尺寸

如果图像的尺寸不同,API 将裁剪图像并将尺寸调整为 600x600 像素,然后创建一个方形的视频。如果所有图像的尺寸均相同,那么视频将按此尺寸显示。

要求

  • 请求必须最少包含 3 张图像,最多包含 7 张。
  • 每张图像的大小不得超过 10MB。

请求语法

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

必填参数

参数 描述

access_token

如果在主页上发布,则为主页访问口令,或者如果在小组上发布,则为用户访问口令。

slideshow_spec

包含一组图像网址以及描述视频的属性的对象。参阅下方的幻灯片对象属性

幻灯片对象属性

属性 说明

images_urls
必填

数组,包含 3 至 7 个用于构建视频的图像的网址。

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 将在响应中提供新构建的视频的编号。

JSON 响应示例

{ "id":"277487313407856" }