Erste Schritte

In diesem Dokument erfährst du, wie du mithilfe der Live Video API eine Live-Video-Übertragung in deinem eigenen Nutzerprofil mit deiner App erstellst. Wenn du noch keine App hast, kannst du den Graph API Explorer und kostenlose Streaming-Software wie zum Beispiel OBS oder Player.me verwenden.

Bevor du beginnst

Du benötigst Zugriff auf Folgendes:

Ein Facebook-Entwicklerkonto
Eine registrierte Facebook-App mit konfigurierten allgemeinen Einstellungen

Wenn du keine App besitzt, benötigst du außerdem Folgendes:

Video-Streaming-Software
Grundlegende Kenntnisse des Graph API Explorer

1. Facebook Login konfigurieren

Füge das Facebook Login-Produkt im App-Dashboard zu deiner App hinzu.

Du kannst für alle Einstellungen die Standardwerte übernehmen. Wenn du Facebook Login manuell implementierst (nicht empfohlen), gib deine redirect_uri in das Feld „Gültige OAuth Redirect URIs“ ein. Wenn du eines unserer SDKs verwendest, kannst du das Feld leer lassen.

2. Facebook Login implementieren

Implementiere Facebook Login gemäß den Anweisungen in unserer Facebook Login-Dokumentation für deine Plattform in deine App. Wenn deine App sich auf einem Gerät befindet, das keine Schnittstelle hat, über die sich Nutzer bei Facebook anmelden können, implementiere stattdessen Facebook Login für Geräte.

Deine App benötigt die folgenden Berechtigungen:

publish_video

Wenn deine App noch nicht fertig ist und du den Graph API Explorer und Streaming-Software verwendest, kannst du diesen Schritt überspringen.

3. Einen Zugriffsschlüssel anfordern

Nachdem du Facebook Login implementiert hast, vergewissere dich, dass du bei deinem Facebook-Entwicklerkonto angemeldet bist. Rufe dann deine App auf und löse den modalen Facebook Login-Dialog aus. Wenn du den Graph API Explorer verwendest, wähle deine App im Dropdown-Menü Facebook-App aus und klicke auf den Button Zugriffsschlüssel generieren.

Nachdem du den modalen Dialog ausgelöst hast, klicke auf das Dropdown-Menü und wähle Nur ich aus. Du bist dann die einzige Person, die diese Übertragung sehen kann. Klicke auf OK und im nächsten modalen Dialog erneut auf OK, um deiner App die Berechtigung publish_video zu gewähren. Die API sollte einen Nutzer*innen-Zugriffsschlüssel zurückgeben. Zeichne den Schlüssel auf, damit deine App ihn in den nächsten Abfragen verwenden kann.

Wenn du den Graph API Explorer verwendest, wird der Schlüssel automatisch aufgenommen und als Referenz im Zugriffsschlüssel-Feld angezeigt:

4. Ein Live-Video-Objekt erstellen

Nachdem du nun über einen Zugriffsschlüssel mit der Berechtigung publish_video verfügst, kannst du damit ein LiveVideo-Objekt in deinem Nutzerprofil erstellen.

Sende eine Anfrage an den Endpunkt POST /me/live_videos?status=LIVE_NOW. Beispiel:

curl -i -X POST \
 "https://graph.facebook.com/v3.3/me/live_videos?status=LIVE_NOW&access_token={access-token}"

Eine Antwort wie die Folgende wird zurückgegeben:

{ 
  "id": "10214937378883406",  //The LiveVideo object ID
  "stream_url": "rtmp://rtmp-api.faceboo...",
  "secure_stream_url": "rtmps://rtmp-api.faceboo...", //The stream URL
  "stream_secondary_urls": [],
  "secure_stream_secondary_urls": []
}

Notiere die zurückgegebenen Werte für id und secure_stream_url. Die id ist die ID des LiveVideo-Objekts, mit der du deine Übertragung bearbeiten kannst. Die secure_stream_url ist die Erfassungs-URL, mit der du Live-Videodaten vom Encoder an das LiveVideo-Objekt streamst.

5. Zur sicheren Stream-URL streamen

Übergib den im letzten Schritt erfassten Wert für secure_stream_url an den Encoder und streame Live-Videodaten an das Gerät. Sobald das LiveVideo-Objekt Streaming-Daten erkennt, wird die Live-Übertragung in deinem Nutzerprofil gestartet.

Zeige dein Profil an und überprüfe, ob ein neuer Live-Videobeitrag erstellt wurde und deine Streaming-Daten überträgt.

Wenn du Streaming-Software verwendest, anstatt deine eigene App zu entwickeln, musst du den Wert für secure_stream_url manuell zur Software hinzufügen. Abhängig von der verwendeten Streaming-Software musst du die Stream-URL möglicherweise in ihre Serverkomponente (rtmps://rtmp-api.facebook.com/rtmp/) und ihre Schlüsselkomponente (alles nach /rtmp/) unterteilen.

In OBS wählst du beispielsweise OBS > Preferences. Der Bildschirm mit Einstellungen wird geöffnet. Lege das Feld Service auf Facebook Live fest, füge die Stream-URL unter Settings > Stream > Stream Key hinzu und starte dann deinen Stream.

6. Übertragung beenden

Nachdem du dich vergewissert hast, dass das Live-Video in deinem Profil übertragen wird, beende die Übertragung, indem du eine Anfrage an den Endpunkt POST /{live-video-id}?end_live_video=true sendest. Beispiel:

curl -i -X POST \
  "https://graph.facebook.com/v3.3/{live-video-id}?end_live_video=true&access_token={access-token}"

Deine Übertragung wird beendet und als Video-on-Demand (VDO) gespeichert. Wenn du das VOD löschen möchtest, sende eine Anfrage an den Endpunkt DELETE /{live-video-id}.

Nächste Schritte

Unter Häufige Anwendungsfälle findest du weitere Beispiele, wie du mit der Live Video API ein Live-Video planen, einen Beitrag in einer Seite oder Gruppe veröffentlichen und Reaktionen und Kommentare von Nutzern erhalten kannst.