Slideshows

Mit der Video API kannst du Slideshow-Videos auf Seiten und in Gruppen veröffentlichen. Für Benutzer kann nicht veröffentlicht werden. In den Beispielen in diesem Dokument wird ein Seiten-Node verwendet. Sie sind jedoch genauso auch auf Gruppen-Nodes übertragbar.

Erstellen einer Slideshow

Sende eine POST-Anfrage an die Seiten-Videos-Edge und schließe dabei ein Objekt ein, das ein Array von Bild-URLs enthält, die zur Videoerstellung verwendet werden sollen. Die Bilder müssen auf einem öffentlich zugänglichen Server gehostet werden. Das Objekt sollte beschreiben, wie lange jedes Bild angezeigt werden soll, und die Übergangsdauer zwischen Bildern angeben.

Bildformate

JPG, JPEG, PNG, BMP, ICO

Bildgrößen

Wenn die Bilder unterschiedlich groß sind, schneidet die API sie zu, passt sie an die Größe 600 x 600 an und erstellt ein quadratisches Video. Wenn alle Bilder dieselbe Größe aufweisen, entspricht das Video dieser Größe.

Anforderungen

Die Anfrage muss mindestens 3 und höchstens 7 Bilder enthalten.
Jedes Bild muss 10 MB oder weniger umfassen.

Anfragesyntax

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

Erforderliche Parameter

Parameter	Beschreibung
`access_token`	Ein Seiten-Zugriffsschlüssel, wenn du auf einer Seite veröffentlichst, oder ein Nutzer-Zugriffsschlüssel, wenn du in einer Gruppe veröffentlichst.
`slideshow_spec`	Ein Objekt mit einem ein Array von Bild-URLs und Eigenschaften, die das Video beschreiben. Siehe Slideshow-Objekteigenschaften unten.

Slideshow-Objekteigenschaften

Eigenschaft	Beschreibung
`images_urls` erforderlich	Ein Array mit 3 bis 7 URLs von Bildern für die Videoerstellung.
`duration_ms`	Eine Ganzzahl, die die Anzeigedauer der einzelnen Bilder im Video in Millisekunden angibt. Der Standardwert ist `1750`. Der Wert muss größer als `0` sein.
`transition_ms`	Eine Ganzzahl, die die Dauer der Überblendung zwischen Bildern in Millisekunden angibt. Der Standardwert ist `250`. Der Wert muss größer als `0` sein.

Beispielanfrage

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

War der Vorgang erfolgreich, antwortet die API mit der ID des neu erstellten Videos.

Beispiel einer JSON-Antwort

{ "id":"277487313407856" }