Dieser Leitfaden bietet einen kurzen Überblick über Übertragungen und Streams. Außerdem werden Anwendungsfälle behandelt, die zeigen, wie Sender die YouTube Live Streaming API verwenden, um diese Ressourcen zu erstellen und zu verwalten.
-
Eine Übertragung steht für ein Ereignis, das auf YouTube in Echtzeit angesehen werden kann. Jede Übertragung ist ein eigenes YouTube-Video. Eine Übertragung kann und muss an genau einen Stream gebunden sein.
-
Mit einem Stream kannst du Audio- und Videoinhalte an YouTube übertragen. Dieser definiert die Einstellungen für das Streaming deiner Inhalte auf YouTube. Ein Stream kann an bis zu drei Liveübertragungen gebunden werden. Es ist auch üblich, dass Sender denselben Stream für viele verschiedene Übertragungen wiederverwenden, wenn diese Übertragungen zu unterschiedlichen Zeiten stattfinden.
In den verbleibenden Abschnitten werden drei Anwendungsfälle vorgestellt, in denen erläutert wird, wie API-Nutzer typischerweise Broadcasts und Streams verwenden.
Einen einzelnen Encoder konfigurieren
Im häufigsten API-Anwendungsfall verfügt dein YouTube-Kanal über eine Reihe geplanter oder wiederkehrender Live-Veranstaltungen. Als Kanalinhaber hast du nur einen Encoder und möchtest ihn nur einmal konfigurieren. Führen Sie dazu die folgenden Schritte aus:
- Erstellen Sie eine
liveStream-Ressource in der API. - Konfiguriere den Encoder für den Kanal mithilfe der Einstellungen für die Inhaltsübermittlung dieser Ressource.
- Erstellen Sie
liveBroadcast-Ressourcen in der API und binden Sie alle diese Ressourcen an dieliveStream-Ressource. In diesem Szenario werden für jede Live-Veranstaltung, die du für deinen Kanal planst, dieselben Streamingeinstellungen verwendet. Allerdings findet immer nur eine Veranstaltung statt und die Videoinhalte für jede Übertragung sind einzigartig. - Wenn eine Veranstaltung stattfindet, aktualisiere den Status der Übertragung entweder zu
testingoderliveund fahre mit der Übertragung der Veranstaltung auf YouTube fort.
Wenn du mehrere Kanäle hast, musst du für jeden Kanal einen eigenen Stream erstellen.
Einen Stream pro Übertragung erstellen
Ein weiterer gängiger Ansatz besteht darin, für jede Übertragung einen separaten Stream zu erstellen. In diesem Szenario würdest du eine eigene liveStream-Ressource für jede liveBroadcast-Ressource erstellen und dann deinen Streaming-Encoder so konfigurieren, dass für jede Übertragung die entsprechenden Einstellungen verwendet werden.
Dieser Ansatz kann sinnvoll sein, wenn auf deinem Kanal mehrere wiederkehrende Broadcasts vorhanden sind und zwei Broadcasts gleichzeitig stattfinden können. In diesem Fall können nicht für beide Broadcasts dieselben Streamingeinstellungen verwendet werden. Tatsächlich könnte dein Kanal jede wiederkehrende Übertragung als Serie behandeln und nur eine liveStream-Ressource pro Serie erstellen. Dann würde jede Folge derselben Sendung eine Übertragung darstellen und alle Sendungen derselben Sendung könnten an denselben Stream gebunden werden.
Gleichzeitige Übertragungen mit nur einem Stream erstellen
In diesem Szenario möchtest du einen Livestream in mehrere gleichzeitig übertragene Livestreams aufteilen. Daher ist eine liveStream-Ressource an zwei (oder mehr) liveBroadcast-Ressourcen gebunden, die gleichzeitig den Status live haben.
Angenommen, Ihr Kanal sendet einen Livefeed rund um die Uhr, Sie möchten aber auch ein separates Video für ein Interview erstellen, das während dieser Übertragung stattfindet. In diesem Fall ist der Interviewinhalt ein Teil des Inhalts der Rund-um-die-Uhr-Übertragung.
Für diesen Fall erstellen Sie zwei liveBroadcast-Ressourcen und binden beide Broadcasts an denselben Stream. Die Übertragung läuft rund um die Uhr und die zugehörige Ressource hat lange vor Beginn des Interviews den Status live. Zu Beginn des Interviews aktualisieren Sie den Status der mit dem Interview verknüpften Ressource auf live, ohne die Ressource für die rund um die Uhr verfügbare Übertragung zu ändern. Das bedeutet, dass Sie denselben Inhalt gleichzeitig in zwei separate Videos streamen.
Wenn das Interview beendet ist, aktualisieren Sie die Ressource der Interviewübertragung noch einmal und setzen den Status diesmal auf complete. Du beendest das Videostreaming aber nicht, da die Übertragung rund um die Uhr fortgesetzt wird.