Códigos de erro

Se você tiver um problema que não foi abordado nesta página, consulte a página de suporte do Google Cast para solucionar suas dúvidas.

Códigos de erro do SDK do Google Cast

Códigos de erro relacionados ao SDK do Cast enviado por eventos de erro ou mensagens de erro de mídia.

Nome Code Descrição Solução
APP 900 Retornado quando ocorre um erro fora do framework (por exemplo, se um manipulador de eventos gera um erro). Investigue o erro que está fora do framework de transmissão.
BREAK_CLIP_LOADING_ERROR 901 Retornado quando há falha no interceptador do carregamento de clipe interrompido. Examine o conteúdo dos clipes de intervalo.
BREAK_SEEK_INTERCEPTOR_ERRO 902 Retornado quando há falha no interceptador da busca de intervalo. Verifique se o interceptador da busca de intervalo está correto.
IMAGEM_ERRO 903 Retornado quando uma imagem não carrega. Verifique se o URL da imagem aponta para o local correto.
LOAD_INTERRUPTED 904 Um carregamento foi interrompido por uma parada ou outro carregamento. Verifique se outra ação causou a interrupção do carregamento.
FALHA_CARREGADA 905 Um comando de carregamento falhou. Verifique se a solicitação de carregamento está configurada corretamente e se a mídia pode ser reproduzida.
MENSAGEM_DE_ERRO_MÍDIA 906 Uma mensagem de erro foi enviada ao remetente. Verifique o Web Receiver ou o remetente para informações sobre o erro.
GENÉRICO 909 Retornado quando ocorre um erro desconhecido. Ocorreu um erro inesperado. Isso é raro.

Códigos de erro da biblioteca do player de mídia

Mensagens de erro relacionadas à reprodução do MPL enviadas por eventos de erro ou mensagens de erro de mídia.

Nome Code Descrição Solução
MEDIA_DESCONHECIDO 100 O elemento de mídia encontrou um erro desconhecido disparado na plataforma. O elemento de mídia encontrou um erro que não indica que é um de MediaError.MEDIA_ERR_*. Isso é raro.
MEDIA_ABORTED 101 O elemento de mídia disparou o erro MediaError.MEDIA_ERR_ABORTED. O processo de busca do recurso de mídia foi cancelado mediante solicitação do usuário. Isso geralmente acontece devido ao cancelamento da reprodução.
CÓDIGO_DE_MEDIA 102 O elemento de mídia disparou o erro MediaError.MEDIA_ERR_DECODE. O desenvolvedor precisa validar os parâmetros de codificação do stream.
MEDIA_NETWORK 103 O elemento de mídia disparou o erro MediaError.MEDIA_ERR_NETWORK O download de dados de mídia falhou porque o Google Cast não usa o elemento de mídia para fazer o download. O problema pode estar no seu app. Se necessário, informe pelo Issue Tracker do Google Cast.
MEDIA_SRC_NOT_COMPATÍVEIS 104 O elemento de mídia disparou o erro MediaError.MEDIA_ERR_SRC_NOT_SUPPORTED . Valide o segmento de dados do desenvolvedor e verifique se os codecs estão incluídos nos formatos compatíveis com Google Cast.
SOURCE_BUFFER_FALHA 110 O Google Cast não consegue adicionar um buffer de origem à fonte de mídia existente. Consulte Web Crypto. Muitas vezes, isso pode ser codecs incorretos especificados no stream de codecs no manifesto do app. Se não estiverem, informe-nos por meio do Rastreador de problemas do Google Cast.
MEDIAKEYS_NETWORK 201 Ao usar o XhrIo em chaves de mídia para postar uma solicitação de licença, encontramos um erro de rede. O desenvolvedor valida o servidor de licença.
MEDIAKEYS_INCOMPATÍVEIS 202 Isso abrange dois casos:
  • Ao usar a sessão de mídia para gerar uma solicitação no EME, encontramos um erro importante.
  • Falha ao inicializar as chaves de mídia EME.
O download de dados de mídia falhou, mas como o Google Cast não usa o elemento de mídia para fazer o download, informe por meio do Rastreador de problemas do Google Cast.
MEDIAKEYS_WEBCRYPTO 203 Ao usar a criptografia da web integrada compatível com o navegador, encontramos um erro de descriptografia. Consulte API Web Crypto. Informe por meio do Rastreador de problemas do Google Cast.
REDE DESCONHECIDA 300 Um erro genérico de rede foi encontrado ao buscar um recurso não coberto no intervalo [301-399] Os desenvolvedores precisam garantir que o conteúdo buscado esteja acessível e que a resposta do servidor seja formada corretamente.
SEGMENT_NETWORK 301* Falha ao recuperar qualquer segmento de qualquer taxa de bits (com três novas tentativas de retiradas exponenciais). Os desenvolvedores precisam validar se os segmentos realmente estão disponíveis. Pode ser que um usuário também não consiga alcançar esses segmentos.
HLS_NETWORK_MASTER_LISTA DE REPRODUÇÃO 311* Falha ao recuperar o arquivo m3u8 da playlist principal com três tentativas. Os desenvolvedores precisam validar se as playlists estão realmente disponíveis. Pode ser que um usuário também não consiga acessar a playlist.
PLAYLIST_REDS_HLS 312* Falha ao recuperar o arquivo m3u8 da playlist de mídia (taxa de bits) com três tentativas. Os desenvolvedores precisam validar se as playlists estão realmente disponíveis. Pode ser que um usuário também não consiga acessar a playlist.
HLS_NETWORK_NO_KEY_RESPOSTA 313 A solicitação de chave de descriptografia não retornou uma resposta. Os desenvolvedores precisam validar o serviço de chaves de descriptografia.
HLS_NETWORK_KEY_CARREGAR 314* Falha no XhrIO usado para solicitar a chave de descriptografia HLS. Os desenvolvedores precisam validar o serviço de chaves de descriptografia.
HLS_NETWORK_INVALID_SEGMENTAR 315 O segmento HLS recebido para processamento não é um segmento TS nem um AAC em mp4. Pode ser bug no MPL ou configuração no bug do app receptor da Web. Os desenvolvedores precisam validar se os segmentos são TS ou AAC.
HLS_SEGMENT_PARSING 316 Retornado quando um segmento HLS não é analisado. Os desenvolvedores precisam validar se os segmentos são formados corretamente.
DASH_REDE 321* A solicitação XHR para conseguir o manifesto do DASH falhou sem resposta. Consulte a seção de estrelas para ver o diagnóstico de erros relacionado à rede.
DASH_NO_INIT 322 Não é possível extrair dados de inicialização do primeiro segmento init DASH. Os desenvolvedores precisam validar o segmento inicial do DASH.
SMOOTH_NETWORK 331* A solicitação XHR para conseguir o manifesto do DASH falhou sem resposta. Consulte a seção de estrelas para ver o diagnóstico de erros relacionado à rede.
SMOOTH_NO_MEDIA_DADOS 332 O segmento transferido por download não contém dados de mídia. Os desenvolvedores precisam validar os segmentos Smooth.
HLS_MANIFEST_MASTER (em inglês) Informações Falha na análise do arquivo de manifesto HLS. Ou algo que o MPL ainda não entenda no m3u8 Examine o conteúdo do URL do manifesto.
HLS_MANIFEST_PLAYLIST 412 Falha na análise do arquivo de playlist de mídia. Ou algo que o MPL ainda não entenda no m3u8 Examine o conteúdo do URL da lista de reprodução de mídia.
DASH_MANIFEST_NO_ PONTOS 421 Ao normalizar o manifesto do Dash, não encontramos pontos nele. Isso é anormal. Os desenvolvedores precisam validar o manifesto DASH.
DASH_MANIFEST_NO_MIME 422 Não há mimetype para uma representação no manifesto. Os desenvolvedores precisam especificar mimetype de áudio/vídeo/texto para suas representações.
DASH_INVALID_SEGMENT_INFORMAÇÃO 423 O MPL está solicitando um índice de segmentos que ultrapassa o tamanho dos segmentos disponíveis, conforme especificado pela representação no manifesto. Denuncie usando links na página de suporte do Google Cast.
SMOOTH_MANIFEST 431 O manifesto smooth não está em conformidade com o padrão. O desenvolvedor precisa resolver um dos seguintes problemas:
  • sem sps
  • qualidade de vídeo inválida
  • qualidade de áudio inválida
  • dados privados do codec de áudio inválidos
  • informações de proteção inválidas
  • sem nível de qualidade
  • mídia desconhecida

Códigos de erro do player Shaka

Para códigos de erro relacionados ao Shaka Player, consulte a documentação da classe de erro do Shaka Player.

Erros de rede comuns

Erro HTTP Código de status Descrição Solução
BAD_REQUEST 400 A solicitação não foi compreendida pelo servidor devido à sintaxe incorreta. O cliente NÃO DEVE repetir a solicitação sem fazer modificações. Há algo errado com o URL. Verificar com desenvolvedores de aplicativos
UNAUTHORIZED 401 A solicitação requer autenticação do usuário Verifique o aplicativo para ver se as informações de autenticação adequadas estão presentes.
NOT_FOUND 404 O cliente pode se comunicar com o servidor, mas o servidor não encontrou o que foi solicitado Os desenvolvedores verificam os recursos de URL e garantem que eles estejam lá.
REQUEST_TIMEOUT 408 O cliente não produziu uma solicitação dentro do tempo em que o servidor estava preparado para aguardar. O cliente PODE repetir a solicitação sem modificações posteriormente. Pode ser um recurso (escalonabilidade do servidor) ou um problema de rede real.
INTERNAL_SERVER_ERRO 500 O servidor encontrou uma condição inesperada que a impediu de atender à solicitação. Os desenvolvedores verificam o problema no servidor.
BAD_GATEWAY 502 Ao agir como gateway ou proxy, o servidor recebeu uma resposta inválida do servidor upstream que ele acessou ao tentar atender à solicitação. Os desenvolvedores verificam a configuração do servidor.
SERVICE_UNAVAILABLE 503 No momento, o servidor não pode processar a solicitação devido a uma sobrecarga ou manutenção temporária do servidor. Isso significa que essa é uma condição temporária que será reduzida depois de algum atraso. Os desenvolvedores verificam a configuração do servidor, especialmente a escalonabilidade dos serviços.
GATEWAY_TIMEOUT 504 O servidor, ao atuar como gateway ou proxy, não recebeu uma resposta do servidor upstream especificada pelo URI em tempo hábil. Os desenvolvedores verificam a configuração e a conexão do servidor entre os servidores de borda e os nós de origem.

Observações

Um código de erro seguido por um asterisco (*) pode ter outros códigos de erro anexados. O formato é:

{Error Code}{Closure Network Error Code}{HTTP Status Code}

Para mais informações, consulte Código de status HTTP.

O exemplo 3016404 tem três partes:

301 Erro de segmentação da rede.
6 Erro de HTTP.
404 Status HTTP não encontrado.

A natureza dos erros de rede: alguns desses erros são acionáveis, enquanto outros não são devido à natureza das operações de rede. Por exemplo, o erro 3018408 que indica um tempo limite pode indicar uma conexão ruim para o usuário, em que a equipe do Google Cast e os desenvolvedores não podem fazer muito sobre isso. Cuidado, isso também pode significar que a CDN do desenvolvedor também está com problemas. Por outro lado, um erro 3116403 significa que a solicitação de manifesto foi feita, mas o servidor se recusou a exibi-la. Podem ser CORS, autenticação ou qualquer outro problema de servidor ou integração que os desenvolvedores precisam verificar.