Resolver problemas

Esta página mostra como resolver problemas com a API Live Stream. Os erros mostrados nesta página são específicos da API Live Stream. Para ver informações sobre erros genéricos nas APIs do Google, consulte a página Erros das APIs do Cloud.

Stream de entrada rejeitado

Se o codificador enviar um fluxo de entrada para um endpoint de entrada, mas a conexão continuar sendo rejeitada, verifique estes possíveis problemas:

URI de endpoint de entrada inválido

Um erro ocorre se o codificador enviar um fluxo de entrada para um URI de endpoint de entrada inválido.

Para resolver esse problema, verifique se o codificador está configurado para enviar o fluxo de entrada para um URI de endpoint de entrada com o endereço IP e STREAM-ID corretos.

A entrada não está anexada a um canal

Um erro ocorre se o codificador enviar um fluxo de entrada para um URI de endpoint de entrada que não está anexado a um canal.

Para resolver esse problema, crie um novo canal com o endpoint de entrada. Para verificar se um endpoint de entrada foi anexado ao canal, confira os detalhes do canal e procure o nome do endpoint de entrada no campo inputAttachments.

Canal inativo

Um erro ocorre se o codificador enviar um fluxo de entrada para um canal que não está em execução.

Para resolver esse problema, verifique o status do canal e confira se o streamingState está AWAITING_INPUT. Se o streamingState do canal for STOPPED, inicie o canal.

Outro codificador já conectado ao mesmo endpoint de entrada

Um erro ocorre se vários codificadores tentarem enviar streams de entrada para o mesmo endpoint de entrada. Apenas uma conexão é aceita por URI de endpoint de entrada.

Para resolver esse problema, verifique se o canal já está no estado STREAMING. Nesse caso, você tem as seguintes opções:

  • Crie um endpoint e um canal de entrada separados para o segundo fluxo de entrada.

  • Pare o primeiro stream de entrada antes de enviar outro para o mesmo endpoint de entrada.

O endereço IP do codificador não está nos intervalos de IP permitidos

Um erro ocorre se o codificador enviar um fluxo de entrada de um endereço IP fora dos intervalos de IP especificados configurados para um endpoint de entrada.

Para resolver esse problema, confira os detalhes de um endpoint de entrada e verifique o campo securityRules. Se houver ipRanges especificados, verifique se o codificador tem um endereço IP válido nesses intervalos.

Arquivos de saída ausentes no bucket do Cloud Storage

Se o codificador estiver enviando um fluxo de entrada para o endpoint de entrada, mas nenhum arquivo de saída aparecer no bucket do Cloud Storage, verifique estes possíveis problemas:

Bucket do Cloud Storage incorreto

Os arquivos de saída podem estar ausentes se você estiver verificando o bucket errado do Cloud Storage.

Para resolver esse problema, confira os detalhes do canal da sua transmissão ao vivo. Verifique o campo output.uri para encontrar o URI do bucket do Cloud Storage correto.

Codecs de vídeo/áudio de entrada inválidos

Os arquivos de saída podem estar ausentes se o codificador estiver enviando codecs de áudio ou vídeo inválidos.

Para resolver esse problema, verifique se o codificador está enviando apenas codecs de vídeo H264 e áudio AAC.

Permissão do Cloud Storage negada

Por padrão, a API Live Stream cria uma conta de serviço que pode acessar buckets do Cloud Storage no mesmo projeto do Google Cloud que hospeda os recursos da API Live Stream. Os arquivos de saída podem estar ausentes se essa conta de serviço perder a permissão para acessar o bucket do Cloud Storage.

Para resolver esse problema, verifique se a conta de serviço tem permissões suficientes. A criação de arquivos de saída pode falhar pelos seguintes motivos:

  • O bucket de saída do Cloud Storage está em um projeto diferente do Google Cloud dos recursos da API Live Stream, como o canal e o endpoint de entrada.

  • As permissões padrão são revogadas da conta de serviço.

Consulte Acesso ao Cloud Storage para mais informações.

Faixas de áudio ausentes

Os arquivos de saída podem estar ausentes se o codificador enviar um fluxo de entrada com faixas de áudio ausentes. O pipeline de vídeo aguarda a chegada de todas as faixas de áudio antes do início do processamento.

Para resolver esse problema, confira os detalhes do canal da sua transmissão ao vivo. Verifique se o codificador está enviando todas as faixas de áudio configuradas no campo ElementaryStream.audioStream.mapping (AudioMapping).