輕影片

影片 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" }