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 stream de entrada para um endpoint de entrada, mas a conexão continuar sendo rejeitada, verifique se há estes possíveis problemas:

URI do endpoint de entrada inválido

Ocorrerá um erro 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 stream de entrada para um URI de endpoint de entrada com o endereço IP e o STREAM-ID corretos.

A entrada não está anexada a um canal

Um erro vai ocorrer 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 stream de entrada para um canal que não está em execução.

Para resolver esse problema, confira o status do canal para garantir que o streamingState é AWAITING_INPUT. Se o streamingState do canal for STOPPED, inicie-o.

Outro codificador já conectado ao mesmo endpoint de entrada

Um erro vai ocorrer se vários codificadores tentarem enviar streams de entrada para o mesmo endpoint de entrada. Apenas uma conexão é aceita por vez 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:

  • Criar um endpoint de entrada e um canal separados para o segundo stream de entrada.

  • Interrompa 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

Ocorrerá um erro se o codificador enviar um stream 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 ipRanges for especificado, 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 stream de entrada para o endpoint de entrada, mas nenhum arquivo de saída aparecer no bucket do Cloud Storage, verifique se há estes possíveis problemas:

Bucket incorreto do Cloud Storage

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 para sua transmissão ao vivo. Verifique o campo output.uri para ver o URI correto do bucket do Cloud Storage.

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

Os arquivos de saída podem estar ausentes caso seu codificador esteja enviando codecs de vídeo ou áudio inválidos.

Para resolver esse problema, verifique se o codificador está enviando apenas codecs de vídeo H264 e 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 a conta de serviço perder 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 do Google Cloud diferente dos recursos da API Live Stream, como o canal e o endpoint de entrada.

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

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

Faixas de áudio ausentes

Os arquivos de saída poderão estar ausentes se o codificador enviar um stream de entrada com faixas de áudio ausentes. O pipeline de vídeo espera até que todas as faixas de áudio cheguem antes do início do processamento.

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