Übersicht

Live-Video-Übertragungen werden durch Live-Video-Objekte in der Graph API dargestellt. Um ein Live-Video zu übertragen, erstellst du zunächst mithilfe der API ein Live-Video-Objekt für einen Nutzer, eine Seite, eine Gruppe oder ein Event. Nach der Erstellung des Objekts gibt die API eine Live-Video-Objekt-ID und eine Erfassungs-Stream-URL zurück. Anschließend kannst du mithilfe der Streaming-URL Live-Videodaten von deinem Encoder an das Live-Video-Objekt übertragen und die Sichtbarkeit der Übertragung mit dem Objekt bearbeiten.

Komponenten

Übertragungen

Live-Video-Übertragungen werden durch Live-Video-Objekte dargestellt. Du steuerst die Live-Video-Übertragung, indem du die Eigenschaften eines Live-Video-Objekts bearbeitest. So kannst du beispielsweise die Sichtbarkeit der Live-Video-Übertragung ändern, ihre Beschreibung oder ihren Titel aktualisieren, Beschriftungen hinzufügen, Zielgruppen definieren, Umfragen hinzufügen und viele andere Aktionen durchführen.

Live-Video-Objekte sind mit Live-Video-Eingabe-Stream-Objekten verknüpft, die die Erfassungs-Streaming-Daten der Übertragung darstellen. Live-Video-Eingabe-Stream-Objekte werden automatisch erstellt und verwaltet.

Übertragungen können für Objekte vom Typ Nutzer, Seite, Gruppe oder Event unter Verwendung des jeweiligen /live_videos-Edge erstellt werden.

Stream-URLs

Stream-URLs sind Erfassungs-URLs, mit denen du Live-Videodaten von deinem Encoder an ein Live-Video-Objekt streamen kannst. Wenn du die API zum Erstellen eines Live-Video-Objekts verwendest, antwortet die API mit einer Live-Video-Objekt-ID und einer eindeutigen Stream-URL. Die Stream-URL muss innerhalb von 24 Stunden verwendet werden. Andernfalls läuft sie ab. Sobald eine Stream-URL verwendet wurde, kann sie bis zu acht Stunden lang gestreamt werden.

Erfassungsprotokolle

Die Live Video API unterstützt das RTMPS-Protokoll.

RTMPS

Daten, die an eine Erfassungs-Stream-URL gestreamt werden, müssen mit dem Datenübertragungsprotokoll RTMPS verschlüsselt werden. Bei der Erstellung eines Live-Video-Objekts gibt die API eine sichere RTMPS-Stream-URL zurück, die du beim Streamen auf unsere Server verwenden kannst.

Im Folgenden sind einige Software- und Hardwareanbieter aufgeführt, die RTMPS unterstützen:

Umfragen

Mit der API kannst du Umfragen zu Live-Video-Übertragungen erstellen und Antworten in Echtzeit von den Betrachtern erhalten. Umfragen werden durch Videoumfrage-Objekte in der Graph API dargestellt und können mit dem Endpunkt POST /{live-video-id}/polls in einem Live-Video-Objekt erstellt werden. Nach der Erstellung des Objekts gibt die API eine Videoumfrage-Objekt-ID zurück, mit der du die Umfrage bearbeiten und Interaktionen der Betrachter abfragen kannst.

Tools

Live Video Composer

Wenn du Streaming-Software verwendest, die sich nicht in die Live Video API integrieren lässt, kannst du mithilfe des Tools „Live Video Composer“ Stream-URLs abrufen und manuell in deine bevorzugte Streaming-Software (z. B. OBS, XSplit usw.) einfügen. Mit dem Live Video Composer kannst du Übertragungen in deinem eigenen Nutzerprofil oder in Seiten, Gruppen oder Events erstellen, die du verwaltest.

Live Ingests

Die Qualität deiner Live-Video-Übertragung beginnt mit einer zuverlässigen Verbindung zu unseren Servern. Instabile Verbindungen können zu schlechter Videoqualität, Unterbrechungen bei der Wiedergabe und fehlgeschlagenen Übertragungen führen. Mit dem Live Ingests-Tool kannst du die Erfassungsqualität testen, um Verbindungsprobleme zu diagnostizieren, den am besten geeigneten Video-Erfassungsserver für deine Übertragung ermitteln und hochwertige Übertragungen mit weniger Problemen bei der Wiedergabe bereitstellen.

Spezifikationen für Videos

In unserer Referenz findest du eine vollständige Liste der Audio- und Videospezifikationen.