Ten przewodnik zawiera krótkie omówienie transmisji i strumieni. Omawiamy także przypadki użycia, które pokazują, jak nadawcy korzystają z interfejsu YouTube Live Streaming API do tworzenia takich zasobów i zarządzania nimi.
-
Transmisja to wydarzenie, które można oglądać w YouTube na bieżąco. Każda transmisja to oddzielny film w YouTube. Transmisja może i musi być powiązana tylko z jednym strumieniem.
-
Strumień służy do przesyłania treści audio-wideo do YouTube i określa ustawienia dotyczące sposobu przesyłania tych treści do YouTube. Ta sama transmisja może być powiązana z maksymalnie 3 transmisjami na żywo. Nadawcy często wykorzystują ten sam strumień do wielu różnych transmisji, jeśli te transmisje odbywają się w różnych momentach.
W pozostałych sekcjach przedstawiamy 3 przypadki użycia, które wyjaśniają, jak użytkownicy interfejsów API zwykle korzystają z transmisji i strumieni.
Skonfiguruj pojedynczy koder
W najczęstszym przypadku użycia interfejsu API kanał YouTube zawiera serię zaplanowanych lub cyklicznych wydarzeń na żywo. Jako właściciel kanału masz jeden koder i chcesz go skonfigurować tylko raz. W związku z tym wykonujesz te czynności:
- Utwórz 1 zasób
liveStreamw interfejsie API. - Użyj ustawień dostawy treści z tego zasobu, aby skonfigurować koder dla kanału.
- Utwórz zasoby
liveBroadcastw interfejsie API i powiąż je wszystkie z zasobemliveStream. W takiej sytuacji każde wydarzenie na żywo zaplanowane na Twoim kanale ma te same ustawienia transmisji. Jednak w danym momencie tylko jedno wydarzenie jest transmitowane, a treść wideo każdej transmisji jest inna. - Za każdym razem, gdy wydarzy się wydarzenie, zmień stan transmisji na
testinglublivei kontynuuj transmitowanie wydarzenia w YouTube.
Pamiętaj, że jeśli masz kilka kanałów, dla każdego z nich musisz utworzyć osobną transmisję.
Utwórz po 1 transmisji na transmisję
Innym typowym podejściem jest utworzenie oddzielnej transmisji dla każdej transmisji. W takim przypadku utworzysz oddzielny zasób liveStream dla każdego zasobu liveBroadcast, a następnie skonfigurujesz koder strumienia danych tak, aby stosował odpowiednie ustawienia dla każdej transmisji.
Takie rozwiązanie może mieć sens, jeśli na Twoim kanale jest wiele transmisji cyklicznych, w których dwie transmisje mogą odbyć się jednocześnie, przez co nie ma możliwości używania tych samych ustawień transmisji w obu przypadkach. Tak naprawdę Twój kanał może traktować każdą transmisję cykliczną jak program i utworzyć po 1 zasobie liveStream na program. Następnie każdy odcinek tego samego programu reprezentuje jedną transmisję i wszystkie transmisje tego samego programu mogą być powiązane z tym samym strumieniem.
Używaj 1 strumienia do jednoczesnego transmitowania
W tym scenariuszu chcesz podzielić transmisję na żywo na kilka transmisji jednocześnie. W związku z tym masz 1 zasób liveStream, który jest powiązany z co najmniej 2 zasobami liveBroadcast o stanie live jednocześnie.
Załóżmy, że na przykład Twój kanał prowadzi całodobowy przekaz na żywo, ale chcesz też utworzyć osobny film z wywiadem, który jest przeprowadzany podczas tej transmisji. W tym przypadku wywiad stanowi podzbiór treści emitowanej przez całą dobę, 7 dni w tygodniu.
Aby to zrobić, utwórz 2 zasoby liveBroadcast i powiąż obie transmisje z tym samym strumieniem. Trwa całodobowa transmisja, a jej zasób ma status live na długo przed rozpoczęciem wywiadu. Po rozpoczęciu wywiadu zaktualizujesz stan zasobu powiązanego z wywiadem na live bez zmiany zasobu transmisji dostępnej przez całą dobę, 7 dni w tygodniu. Dlatego te same treści są przesyłane do dwóch osobnych filmów jednocześnie.
Po zakończeniu wywiadu ponownie aktualizujesz zasoby transmisji, tym razem ustawiając jej status na complete. Nie zatrzymasz jednak transmisji wideo, ponieważ trwa ona całodobowo.