Dieses Dokument wurde aktualisiert.
Die Übersetzung ins Deutsche ist noch nicht fertig.

Englisch aktualisiert: 26.01.2022

Referenz

Empfohlene Einstellungen

Um eine erfolgreiche Übertragung von Live-Videos sicherzustellen, müssen Bedingungen erfüllt sein:

Sie müssen sowohl Audio- als auch Videodaten enthalten.
Sie dürfen nicht länger als acht Stunden dauern.
Sie müssen empfohlene Einstellungen wie unten angegeben verwenden (Beispiel: Sie müssen im Format H264/AAC sein).
Einstellungen dürfen während der Übertragung nicht geändert werden.

Wenn diese Bedingungen nicht eingehalten werden, kann Folgendes passieren:

Unerwartete Beendung des Streams
Niedrigere Qualität für Zuschauer
Unerwartetes Verhalten

Videoeinstellungen

Keyframe-Größe: 2 Sekunden (empfohlen). Die Höchstgrenze von 4 Sekunden darf nicht überschritten werden.
Auflösung und Bitrate:
1080p bei 60 FPS
Auflösung: 1920x1080
Bereich der Video-Bitrate: 4.500 bis 9.000 KBit/s
1080p bei 30 FPS
Auflösung: 1920x1080
Bereich der Video-Bitrate: 3.000 bis 6.000 KBit/s
720p bei 60 FPS
Auflösung: 1280x720
Bereich der Video-Bitrate: 2.250 bis 6.000 KBit/s
720p bei 30 FPS
Auflösung: 1280x720
Bereich der Video-Bitrate: 1.500 bis 4.000 KBit/s
480p bei 30 FPS
Auflösung: 854x480
Bereich der Video-Bitrate: 600 bis 2.000 KBit/s
360p
Auflösung: 640x360
Bereich der Video-Bitrate: 400 bis 1.000 KBit/s
Protokoll: RTMPS Streaming
Pixel-Bildseitenverhältnis: Möglichst 16:9. Wenn du zu stark von diesem Seitenverhältnis abweichst, können wir deinen Stream unter Umständen nicht unterstützen.
Video-Codec:
- H.264, Level 4.1 für bis zu 1080p bei 30 FPS
- H.264, Level 4.2 für 1080p bei 60 FPS

Audioeinstellungen

Audio-Codec: AAC, Low Complexity
Samplerate: 44,1 oder 48 kHz
Audio-Bitrate: 128 KBit/s (empfohlen) bis 256 KBit/s (maximal)
Kanal-Layout: Stereo

Endpunkte

LiveVideo

Endpunkt	Beschreibung
`DELETE /{live_video_id}`	LiveVideo löschen.
`GET /{event-id}/live_videos`	Eine Collection von LiveVideos zu einem Event abrufen.
`GET /{group-id}/live_videos`	Eine Collection von LiveVideos zu einer Gruppe abrufen.
`GET /{live-video-id}`	Felder und Edges zu einem LiveVideo abrufen.
`GET /{live-video-id}/comments`	Eine Collection von Kommentaren zu einem LiveVideo abrufen.
`GET /{live-video-id}/crosspost_shared_pages`	Eine Collection von Seiten abrufen, die ein LiveVideo teilen können.
`GET /{live-video-id}/likes`	Eine Collection von Profilen abrufen, die ein LiveVideo mit „Gefällt mir“ markiert haben.
`GET /{live-video-id}/polls`	Eine Collection von VideoPolls zu einem LiveVideo abrufen.
`GET /{live-video-id}/reactions`	Eine Collection von Profilen abrufen, die auf ein LiveVideo reagiert haben.
`GET /{page-id}/live_videos`	Eine Collection von LiveVideos zu einer Seite abrufen.
`GET /{user-id}/live_videos`	Eine Collection von LiveVideos zu einem Nutzer abrufen.
`POST /{event-id}/live_videos`	Ein LiveVideo zu einem Event erstellen.
`POST /{group-id}/live_videos`	Ein LiveVideo zu einer Gruppe erstellen.
`POST /{live_video_id}`	Felder für ein LiveVideo aktualisieren.
`POST /{live_video_id}/input_streams`	Einen LiveVideoInputStream zu einem LiveVideo erstellen.
`POST /{live_video_id}/polls`	Eine VideoPoll zu einem LiveVideo erstellen.
`POST /{page-id}/live_videos`	Ein LiveVideo zu einer Seite erstellen.
`POST /{user-id}/live_videos`	Ein LiveVideo zu einem Nutzer erstellen.

LiveVideoInputStream

Endpunkt	Beschreibung
`GET /{live-video-input-stream-id}`	Felder und Edges zu einem LiveVideoInputStream abrufen.
`POST /{live_video_id}/input_streams`	Einen LiveVideoInputStream zu einem LiveVideo erstellen.

Umfragen

Endpunkt	Beschreibung
`GET /{live-video-id}/polls`	Eine Collection von VideoPolls zu einem LiveVideo abrufen.
`GET /{video-poll-id}`	Felder und Edges zu einer VideoPoll abrufen.
`POST /{live_video_id}/polls`	Eine VideoPoll zu einem LiveVideo erstellen.
`POST /{video_poll_id}`	Felder zu einer VideoPoll aktualisieren.

Fehlercodes

Fehlermeldungen werden via RTMP gesendet und dann dauerhaft an die Graph API weitergegeben. Du kannst die Broadcast-/Video-ID verwenden und eine Abfrage zu den Fehlern im Graph Explorer-Tool mittels GET-Anforderung durchführen. Zurückgegebene Fehler enthalten den Fehlercode, die Beschreibung und einen Zeitstempel.

error_subcode	Fehlerzusammenfassung	Beschreibung
`COPYRIGHT__LIVE_COPYRIGHT_VIOLATION`	Urheberrechtsverstoß eines Live-Videos	Dein Live-Video wurde angehalten, weil es möglicherweise Audio- oder Videoinhalte umfasst, die zu einer anderen Seite gehören.
`VIDEO__CREATE_FAILED`	Upload-Problem	Es ist ein Problem aufgetreten. Dein Video wurde nicht hochgeladen. Bitte versuche es erneut.
`LIVE_VIDEO__DELETE_FAILED`	Live-Video wurde nicht gelöscht	Es ist ein Problem aufgetreten. Dein Live-Video konnte nicht gelöscht werden. Bitte versuche es erneut.
`LIVE_VIDEO__EDIT_API_NOT_ALLOWED`	Bearbeitung per Video-API ist im Live-Modus nicht zulässig	Die Bearbeitung eines Live-Videos mit der Video Edit API ist nicht zulässig. Verwende die Live-Video-ID.
`LIVE_VIDEO__LIVE_STREAM_ERROR`	Generischer Stream	Beim Streamen ist ein Fehler aufgetreten.
`LIVE_VIDEO__NOT_EXIST`	Live-Video existiert nicht	Das Live-Video, auf das du zugreifen möchtest, ist nicht mehr im System vorhanden.
`LIVE_VIDEO__PRIVACY_REQUIRED`	Datenschutzeinstellung erforderlich	Du musst eine Datenschutzeinstellung vornehmen, bevor du live gehst.