Erste Schritte

In diesem Dokument erfährst du, wie du mithilfe der Live Video API eine Live-Video-Übertragung mit deiner App überträgst. Wenn du noch keine App hast, kannst du den Graph API Explorer und eine beliebige Streaming-Software verwenden.

Bevor du beginnst

Wenn du eine App besitzt, benötigst du Folgendes:

• Eine Meta-App-ID mit dem Anwendungsfall „Facebook Login“
• Facebook Login-Implementation in deiner App

  • Wenn deine App sich auf einem Gerät befindet, das keine Schnittstelle hat, über die sich Nutzer*innen bei Facebook anmelden können, implementiere stattdessen Facebook Login für Geräte .
• Die folgenden Berechtigungen: publish_video
• Einen Zugriffsschlüssel

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

• Den Graph API Explorer
• Video-Streaming-Software

Übertragung starten

Um ein LiveVideo-Objekt zu erstellen, sendest du eine POST-Anfrage an den /me/live_videos?status=LIVE_NOW-Endpunkt, wobei me die ID des*der Nutzer*in oder der Seite ist.

curl -i -X POST \
 "https://graph.facebook.com/v21.0/me/live_videos?status=LIVE_NOW"

Es wird eine Antwort ähnlich der folgenden 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.

Übertragung 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 Nutzungsprofil 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.

Übertragung beenden

Um die Übertragung zu beenden, sendest du eine POST-Anfrage an den /<LIVE_VIDEO_ID>?end_live_video=true-Endpunkt.

Beispiel einer Anfrage zum Beenden einer Übertragung

curl -i -X POST \
  "https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?end_live_video=true"

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>.

Fehlercodes bei Verweigerung von Berechtigungen

Nächste Schritte

• Verwende die Live Video API, um ein Live-Video für eine zukünftige Übertragung zu planen.