슬라이드쇼

동영상 API를 사용하면 페이지와 그룹에 슬라이드쇼 동영상을 게시할 수 있습니다. 사용자에 대한 게시는 지원되지 않습니다. 이 문서의 모든 예시는 페이지 노드를 사용하지만 그룹 노드에도 똑같이 적용됩니다.

슬라이드쇼 만들기

POST 요청을 페이지 동영상 에지로 보내고 동영상 구성에 사용할 이미지 URL 배열이 있는 개체를 포함합니다. 이미지는 공개적으로 액세스할 수 있는 서버에서 호스팅해야 합니다. 개체는 각 이미지를 재생하는 시간과 이미지 간의 전환 간격을 설명해야 합니다.

이미지 형식

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`	이미지 URL 배열과 동영상을 설명하는 속성이 포함된 개체. 아래의 슬라이드쇼 개체 속성을 참조하세요.

슬라이드쇼 개체 속성

속성	설명
`images_urls` 필수	동영상 구성에 사용할 이미지 URL 3~7개가 포함된 배열.
`duration_ms`	각 이미지가 동영상에 표시되어야 하는 시간(ms)을 나타내는 정수. 기본값은 `1750`입니다. 값은 `0`보다 커야 합니다.
`transition_ms`	이미지 간의 크로스페이드 전환 시간(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" }