API YouTube Live Streaming – Noções básicas sobre transmissões e transmissões

Este guia fornece uma breve visão geral de transmissões e transmissões. Ela também aborda casos de uso que mostram como as pessoas que fazem transmissões usam a API YouTube Live Streaming para criar e gerenciar esses recursos.

  • Uma transmissão representa um evento que pode ser visto no YouTube no momento em que ele acontece. Cada transmissão é um vídeo diferente do YouTube. Uma transmissão pode ser e precisa estar vinculada a exatamente um fluxo.

  • Um stream permite que você transmita conteúdo de áudio e vídeo para o YouTube, além de definir as configurações de streaming do seu conteúdo para o YouTube. O mesmo stream pode ser vinculado a até três transmissões ao vivo. Também é comum que emissores reutilizem o mesmo stream para muitas transmissões diferentes se elas ocorrerem em momentos distintos.

As demais seções apresentam três casos de uso que explicam como os usuários da API costumam usar transmissões e streams.

Configurar um único codificador

No caso de uso de API mais comum, seu canal do YouTube tem uma série de eventos ao vivo programados ou recorrentes. Como proprietário do canal, você tem apenas um codificador e só quer configurá-lo uma vez. Portanto, você cria um recurso liveStream na API e usa as configurações de exibição de conteúdo desse recurso para configurar o codificador do canal. Se você tiver vários canais, precisará criar um stream diferente para cada um deles.

Em seguida, crie recursos liveBroadcast na API e vincule todos eles ao recurso liveStream. Neste cenário, todos os eventos ao vivo que você programa para seu canal usam as mesmas configurações de transmissão. No entanto, apenas um evento fica ativo em cada momento, e o conteúdo de vídeo de cada transmissão é único.

Sempre que um evento ocorrer, você vai atualizar o status da transmissão para testing ou live e transmitir o evento no YouTube.

Criar um stream por transmissão

Outra abordagem comum é criar um stream separado para cada transmissão. Nesse cenário, você criaria um recurso liveStream distinto para cada recurso liveBroadcast e configuraria seu codificador de streaming para usar as configurações apropriadas para cada transmissão.

Essa abordagem pode fazer sentido se o canal tiver várias transmissões recorrentes para que duas transmissões ocorram simultaneamente, o que torna inviável que ambas usem as mesmas configurações de streaming. Seu canal pode tratar cada transmissão recorrente como um programa e criar apenas um recurso liveStream por programa. Assim, cada episódio do mesmo programa representa uma transmissão, e todas as transmissões do mesmo programa podem ser vinculadas ao mesmo stream.

Usar um único stream para criar transmissões simultâneas

Neste cenário, você quer dividir uma transmissão ao vivo em várias transmissões simultâneas. Dessa forma, você tem um recurso liveStream vinculado a dois (ou mais) recursos liveBroadcast que têm um status live ao mesmo tempo.

Por exemplo, suponha que seu canal transmita um feed ao vivo 24 horas por dia, 7 dias por semana, mas você também quer criar um vídeo separado para uma entrevista que ocorra durante essa transmissão. Nesse caso, o conteúdo da entrevista é um subconjunto do conteúdo da transmissão 24 horas por dia, 7 dias por semana.

Para lidar com esse caso, crie dois recursos liveBroadcast e vincule as duas transmissões ao mesmo stream. A transmissão 24 horas está em andamento e o recurso dela tem um status live muito antes do início da entrevista. Quando a entrevista começa, você atualiza o status do recurso associado à entrevista para live sem mudar o recurso da transmissão 24 horas. Assim, você está transmitindo o mesmo conteúdo para dois vídeos diferentes ao mesmo tempo.

Quando a entrevista terminar, você vai atualizar o recurso da transmissão novamente, desta vez definindo o status como complete. No entanto, você não interrompe o streaming de vídeo porque a transmissão 24 horas continua.