API de transmissão ao vivo do YouTube - Noções básicas sobre transmissões e transmissões

Este guia fornece uma breve visão geral de transmissões e streams. Também discute casos de uso que mostram como as emissoras usam a API de transmissão do YouTube ao vivo 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 e precisa estar vinculada a exatamente um stream.

  • Um stream permite que você transmita conteúdo de áudio e vídeo para o YouTube e define as configurações de como você transmite seu conteúdo para o YouTube. A mesma transmissão pode ser vinculada a até três transmissões ao vivo. Também é comum que as emissoras reutilizem o mesmo stream para muitas transmissões diferentes se elas ocorrerem em momentos diferentes.

As seções restantes apresentam três casos de uso que explicam como os usuários da API normalmente usam 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 um único codificador e só quer configurá-lo uma vez. Por isso, execute as seguintes etapas:

  1. Crie um recurso liveStream na API.
  2. Use as configurações de envio de conteúdo desse recurso para configurar o codificador do canal.
  3. Se você tiver vários canais, será necessário criar uma transmissão diferente para cada um deles.

  4. Crie recursos liveBroadcast na API e vincule todos eles ao recurso liveStream. Nesse caso, todos os eventos ao vivo programados para seu canal usam as mesmas configurações de transmissão. No entanto, somente um evento é transmitido ao vivo por vez, e o conteúdo de vídeo de cada transmissão é único.
  5. Sempre que ocorrer um evento, atualize o status da transmissão para testing ou live e continue com a transmissão do evento no YouTube.

Criar uma transmissão 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 caso seu canal tenha várias transmissões recorrentes, de forma que duas transmissões possam ocorrer ao mesmo tempo, tornando inviável que ambas as transmissões usem as mesmas configurações de streaming. Na verdade, seu canal pode tratar cada transmissão recorrente como um programa e criar apenas um recurso de liveStream por programa. Assim, cada episódio do mesmo programa representaria uma transmissão, e todas as transmissões do mesmo programa poderiam estar vinculadas ao mesmo stream.

Usar um 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 com status live ao mesmo tempo.

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

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 tem um status live muito antes do início da entrevista. No início da entrevista, você atualiza o status do recurso associado à entrevista para live sem alterar o recurso da transmissão 24 horas. Assim, você está transmitindo o mesmo conteúdo em dois vídeos diferentes ao mesmo tempo.

Quando a entrevista termina, você atualiza o recurso da transmissão da entrevista 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.