Interfejs YouTube Live Streaming API – informacje o transmisjach i transmisjach

Ten przewodnik zawiera krótkie omówienie transmisji i transmisji. Omawiamy także przypadki użycia, które pokazują, jak nadawcy tworzą treści i zarządzają nimi za pomocą interfejsu YouTube Live Streaming API.

  • 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 być i musi być powiązana tylko z jednym strumieniem.

  • Strumień umożliwia przesyłanie treści audio i wideo do YouTube oraz określanie ustawień strumieniowego przesyłania tych treści do YouTube. Ta sama transmisja może mieć maksymalnie 3 transmisje. Nadawcy korzystający z tej samej transmisji często wykorzystują też ten sam strumień w różnych momentach.

W pozostałych sekcjach przedstawiamy 3 przypadki użycia wyjaśniające, jak użytkownicy interfejsu API zazwyczaj korzystają z transmisji.

Skonfiguruj jeden koder

W najczęstszym przypadku użycia API kanał w YouTube zawiera serię zaplanowanych lub cyklicznych wydarzeń na żywo. Jako właściciel kanału masz jeden koder i chcesz go skonfigurować tylko raz. Utworzysz więc 1 zasób liveStream w interfejsie API, a potem użyjesz ustawień dostawy treści z tego zasobu do skonfigurowania kodera kanału. (jeśli masz kilka kanałów, musisz utworzyć oddzielny strumień dla każdego z nich).

Następnie możesz utworzyć liveBroadcast zasobów w interfejsie API i powiązać te zasoby z zasobem liveStream. W takiej sytuacji każde wydarzenie na żywo zaplanowane na kanale ma takie same ustawienia transmisji. Jednak w danym momencie tylko jedno wydarzenie jest aktywne, a treści wideo dotyczące poszczególnych transmisji są unikalne.

Za każdym razem, gdy wydarzenie następuje, zmieniasz jego stan na testing lub live i kontynuujesz transmisję w YouTube.

Utwórz 1 strumień na transmisję

Innym częstym podejściem jest utworzenie oddzielnego strumienia dla każdej transmisji. W takim przypadku musisz utworzyć oddzielny zasób liveStream dla każdego zasobu liveBroadcast, a następnie skonfigurować koder tak, aby używał odpowiednich ustawień każdej transmisji.

Ta metoda może być odpowiednia, jeśli na Twoim kanale jest kilka transmisji cyklicznych, co może obejmować 2 transmisje jednocześnie. W rezultacie niemożliwe jest zastosowanie tych samych ustawień transmisji. Tak naprawdę Twój kanał może traktować każdy cykl transmisji w formie programu i tworzyć tylko liveStream zasób na program. Następnie każdy odcinek tego samego programu będzie reprezentować transmisję i z tym samym strumieniem mogą być powiązane wszystkie transmisje.

Używanie jednego strumienia do jednoczesnego tworzenia transmisji

W tym scenariuszu chcesz podzielić transmisję na żywo na kilka jednoczesnych transmisji. Masz więc 1 zasób typu liveStream, który jest powiązany z 2 lub większą liczbą zasobów liveBroadcast o stanie live w tym samym czasie.

Załóżmy na przykład, że na kanale masz całodobową transmisję na żywo, ale chcesz także utworzyć oddzielny film do wywiadu, który będzie miał miejsce podczas tej transmisji. W tym przypadku wywiad stanowi część treści całodobowej transmisji.

Aby rozwiązać ten problem, utwórz 2 zasoby liveBroadcast i powiąż oba transmisje z tym samym strumieniem. Całodobowa transmisja jest aktywna, a jej zasób ma stan live na długo przed rozpoczęciem rozmowy. Po rozpoczęciu wywiadu możesz zaktualizować stan powiązanego z nim zasobu na live bez zmieniania zasobu transmisji na żywo. W ten sposób odtwarzasz tę samą treść w 2 oddzielnych filmach jednocześnie.

Po zakończeniu rozmowy trzeba ponownie zaktualizować zasób transmisji, tym razem ustawiając jej stan na complete. Nie można jednak zatrzymać transmisji wideo przez całą dobę.