Solucionar problemas nos Serviços de Mídia

Logotipo dos Serviços de Mídia v3


Site do AMS | Documentação dos Serviços de Mídia v2 | Exemplos de código | Guia de solução de problemas

Encontre as causas e soluções de problemas com os Serviços de Mídia.

Observação

Muitos problemas podem ser resolvidos migrando para a API do Serviços de Mídia v3 ou lendo o guia de melhores práticas de transmissão ao vivo.

Problemas de conta

Causa Solução
Você pode estar tentando usar recursos da API v3 com uma conta ou uma implementação da API v2. Atualize o código para usar a API v3. Para obter assistência mais detalhada, consulte o Guia de migração.

Problemas comuns de reprodução de vídeo

  • Os vídeos levam muito tempo para começarem a ser reproduzidos.
  • Os vídeos ficam desfocados quando começam a ser reproduzidos.
  • A qualidade do vídeo é baixa.
  • O vídeo não é reproduzido ou mostra uma tela preta.
Causa Solução
Você pode estar tentando alcançar um público grande sem usar uma CDN, o que está causando problemas de latência. Adicione uma CDN ao seu localizador de streaming. Para obter mais informações sobre o uso da CDN, consulte Transmitir conteúdo com a integração da CDN.
Talvez você não tenha implementado o empacotamento dinâmico. Para obter mais informações sobre como implementar o empacotamento dinâmico, consulte Empacotamento dinâmico nos Serviços de Mídia v3.
Você pode ter o que é conhecido como "vizinhos barulhentos", o que significa que está compartilhando recursos de computação com outros clientes. Para evitar "vizinhos barulhentos", faça upgrade do ponto de extremidade de streaming Standard para o ponto de extremidade de streaming Premium, com unidades de streaming dedicadas.
Você pode estar usando um navegador mais antigo para exibir os vídeos. Atualize o navegador.
Você pode estar usando um player e filtros de terceiros. Adicione audio-only=false à URL de streaming, por exemplo, https://streamingtest.streaming.media.azure.net/00000000-0000-0000-0000-000000000000/sample.ism/manifest(format-m3u8-aapl,audio-only=false)

Você não pode reproduzir um arquivo MP4 do ativo

Causa Solução
Os Serviços de Mídia do Azure foram projetados para usar um arquivo de manifesto em vez de reproduzir fluxos MP4 em tamanho total diretamente. O arquivo de manifesto informa ao player quais fragmentos de mídia codificados reproduzir e em qual ordem. Use um dos codificadores de mídia fornecidos para criar fragmentos de mídia e o arquivo de manifesto. Para obter mais informações sobre a codificação, consulte Codificação com reconhecimento de conteúdo e Codificar com uma codificação de escada de taxa de bits gerada automaticamente.
O nome do arquivo contém caracteres reservados. Remova os caracteres reservados do nome do arquivo.

Caracteres reservados

  • Os Serviços de Mídia usam o valor do nome de arquivo do ativo ao criar URLs para conteúdo de streaming. Por esse motivo, não é permitida a codificação por porcentagem. O valor da propriedade de nome não pode ter nenhum dos seguintes caracteres reservados para codificação de percentual: !*'();:@&=+$,/?%#[]". Além disso, pode haver somente um '.' para a extensão de nome de arquivo.
  • O comprimento do nome não deve ser maior do que 260 caracteres.

O conteúdo criptografado não é reproduzido no modo offline.

Causa Solução
O player que você está usando para executar os vídeos criptografados em AES baixados no modo offline em dispositivos iOS determina como esses vídeos são executados. A causa não está nos Serviços de Mídia. Examine a documentação do player de vídeo offline escolhido.

O áudio está fora de sincronia.

Causa Solução
Os pacotes de vídeo estão sendo entregues com atraso. Soluções possíveis:

1. Você pode ter implementado uma política de controle de versão de armazenamento que foi ativada automaticamente, o que causa buffer e desconexão. Remova a política e desative o controle de versão de armazenamento automático.
2. Habilitar uma CDN.
3. Usar um ponto de extremidade de streaming Premium com unidades reservadas suficientes.

A solicitação do player para o arquivo VTT causou erros de CORS.

Causa Solução
Configuração de regras de CORS Configure regras de CORS para a conta de armazenamento ou CDN.

Você também pode obter a URL de download do arquivo VTT do ativo.

Um ponto de extremidade de streaming não é iniciado.

Causa Solução
Você pode ter criado uma política personalizada que habilita apenas HTTPS. Atualmente, isso não tem o suporte dos Serviços de Mídia. Possíveis soluções alternativas:
1. No portal do Azure, desabilite a política personalizada.
2. Crie um ponto de extremidade de streaming com uma CDN habilitada e desabilite o HTTP para o ponto de extremidade da CDN.
Or
1. Não habilite a CDN para o ponto de extremidade de streaming com o portal ou a API.
2. Em vez disso, vá para a página da CDN do Azure no portal do Azure ou use a API da CDN do Azure para criar um ponto de extremidade que aponta para o ponto de extremidade dos Serviços de Mídia, definindo a origem do ponto de extremidade da CDN como o nome do host do ponto de extremidade de streaming.
Talvez você tenha parado um ponto de extremidade de streaming com uma CDN. Consulte O ponto de extremidade de streaming não para

Um ponto de extremidade de streaming com uma CDN não para.

Causa Solução
Quando você habilitar a CDN para um ponto de extremidade de streaming, o ponto de extremidade da CDN não será criado até que você inicie o ponto de extremidade de streaming. Por esse motivo, durante o processo de início, a plataforma criará os pontos de extremidade da CDN e os vinculará ao ponto de extremidade de streaming (incluindo a configuração do nome do host personalizado).

Durante o processo de parada para o ponto de extremidade de streaming, a plataforma deve excluir o ponto de extremidade da CDN. Portanto, se o ponto de extremidade de streaming estiver em estado de parada, o ponto de extremidade da CDN não existirá nem apontará para o ponto de extremidade de streaming.

No entanto, em alguns cenários, quando o AMS chama a CDN para excluir os pontos de extremidade da CDN, ele falha ao excluir pontos de extremidade devido a caches na CDN. Isso resultará em um problema de conflito de nome de host se o ponto de extremidade da CDN ainda estiver lá e disparar o problema de interrupção do ponto de extremidade de streaming.
Exclua manualmente o perfil da CDN e, em seguida, exclua o ponto de extremidade de streaming e configure um novo.

Os pontos de extremidade de streaming não aparecem depois de mover a conta para uma assinatura diferente.

Causa Solução
Leva algum tempo para que os pontos de extremidade de streaming sejam movidos para a nova assinatura. Aguarde duas horas e verifique se os pontos de extremidade de streaming estão aparecendo na nova assinatura.

O codificador local não está enviando dados ao evento ao vivo.

Causa Solução
Você pode estar usando um codificador que não foi testado com os Serviços de Mídia. Consulte Codificadores de transmissão ao vivo locais verificados.
O codificador local pode não estar configurado corretamente. Confirme se você configurou corretamente o codificador local.

A codificação parece estar demorando muito.

A maioria dos problemas de duração de codificação pode ser resolvida definindo as configurações do codificador para controlar o equilíbrio entre velocidade e qualidade. Para ter uma codificação mais rápida, defina como o modo de velocidade.

Causa Solução
O arquivo de mezanino pode ser muito grande. O tamanho do arquivo é igual à taxa de bits multiplicada pela duração. Nenhum
Há um alto número de camadas de saída. Reduza o número de camadas de saída.
As camadas de saída têm alta resolução. Reduza a resolução da camada de saída para a taxa de bits em que você pretende transmitir mídia.
O arquivo de mezanino pode ser complexo, especialmente se você está codificando um arquivo com resolução de 4k. Nenhum

Falhas de transformação

Causa Solução
Talvez você tenha ultrapassado a cota de transformações por conta, que é de 100. Excluir transformações não utilizadas.

Não é possível carregar mídia

Não é possível carregar mídia em uma conta de armazenamento.

Causa Solução
Você está tentando usar HTTP. Use o HTTPS. O protocolo HTTP não tem mais suporte para carregar conteúdo.
Você não está esperando o suficiente para que a conta de armazenamento seja implantada. Se você criou a conta de armazenamento programaticamente, adicione código para testar se ela foi implantada antes de tentar carregar mídia.

Problemas do CORS

Causa Solução
Se você estiver tentando usar solicitações de simulação contendo cabeçalhos de rastreamento pai, receberá erros o CORS. No momento, os Serviços de Mídia não têm suporte para solicitações de simulação. Estamos cientes de que as solicitações de simulação são importantes para nossos clientes. Não use solicitações de simulação até que o recurso esteja disponível.

Problemas de conexão da conta de armazenamento

Estado Desconectado

O estado "Desconectado" de uma conta de Serviços de Mídia indica que a conta não tem mais acesso a uma ou mais contas de armazenamento anexadas, devido a uma alteração nas chaves de acesso de armazenamento. Os Serviços de Mídia exigem chaves de acesso de armazenamento atualizadas para realizar várias tarefas na conta.

Veja a seguir os principais cenários que fariam com que a conta de Serviços de Mídia não tivesse acesso às contas de armazenamento anexadas.

Causa Solução
A conta de Serviços de Mídia ou as contas de armazenamento anexadas foram migradas para assinaturas separadas. Migre as contas de armazenamento ou dos Serviços de Mídia para que elas fiquem todas na mesma assinatura ou usem a identidade gerenciada para autenticação da conta de armazenamento se sua conta de armazenamento estiver no mesmo locatário.
A conta de Serviços de Mídia está usando uma conta de armazenamento anexada em uma assinatura diferente, já que ela era uma conta Serviços de Mídia inicial compatível com este cenário. Todas as contas de Serviços de Mídia iniciais foram convertidas em contas modernas baseadas no Azure Resource Manager e terão o estado de Desconectadas. Migre as contas de armazenamento ou dos Serviços de Mídia para que elas fiquem todas na mesma assinatura ou usem a identidade gerenciada para autenticação da conta de armazenamento se sua conta de armazenamento estiver no mesmo locatário.

A conta dos Serviços de Mídia não pode acessar a conta de armazenamento

Causa Solução
A identidade gerenciada dos Serviços de Mídia não recebeu a função Colaborador de Dados do Blob de Armazenamento. Para verificar isso no Portal do Azure, primeiro descubra qual identidade está definida para a conta de armazenamento selecionando "Contas de armazenamento" no menu da conta dos Serviços de Mídia; deve ser "Atribuído pelo sistema" ou o nome de uma Identidade Gerenciada atribuída pelo usuário. Em seguida, acesse a conta de armazenamento no portal, selecione "Controle de Acesso (IAM)" no menu, selecione "Atribuições de função" na barra de ferramentas e adicione a atribuição de função. Ao adicionar a atribuição de função, a Função deve ser definida como "Colaborador de Dados do Blob de Armazenamento" e os membros devem ser definidos como a Identidade Gerenciada usada pela conta dos Serviços de Mídia para acessar a conta de armazenamento. Depois de adicionar a atribuição de função, pode levar alguns minutos para que a alteração entre em vigor.

O Azure Media Indexer 2 não está sendo retornado na lista de processadores de mídia.

Causa Solução
O Azure Media Indexer 2 foi preterido em 1º de janeiro de 2020. Migre para a API dos Serviços de Mídia v3.

Um erro de rede fez com que o download do vídeo falhasse no meio do caminho.

Causa Solução
Geralmente, esse erro é resultado de problemas de conexão de rede no lado do cliente, e não dos Serviços de Mídia. Contate o administrador de rede ou use a depuração do Fiddler ou do navegador F12 para ver o erro subjacente.

Problemas de download

Você pode ter recebido o seguinte erro:

"Ao tentar baixar os arquivos de entrada, os arquivos não estavam acessíveis, verifique a disponibilidade da origem"

Causa Solução
Se você estiver usando um token SAS para acessar o arquivo, ele pode ter expirado. Ajuste o código para verificar se o token não expirou antes de usá-lo para autenticar.

Erros 5xx excessivos e intermitentes

Causa Solução
A codificação local pode ter sido implementada incorretamente. Verifique se o codificador está configurado corretamente.
Você pode estar usando um codificador local não testado Use um codificador local testado e verifique se ele está configurado corretamente.
A taxa de cache entre o ponto de extremidade de streaming e a CDN pode ser insuficiente. 1. Ajuste a taxa de cache para que a CDN processe mais tráfego.
2. Ajuste a regra de otimização de streaming para a CDN.
A configuração do filtro pode estar incorreta. Verifique se os filtros foram configurados corretamente.

Consulte o Guia de melhores práticas de transmissão ao vivo.

Erros de código gerais

Você pode estar enfrentando erros no código que não se encaixam nas referências de códigos de erro de ponto de extremidade de streaming, códigos de erro de evento ao vivo ou códigos de erro de trabalho.

Causa Solução
Você pode estar tentando usar um objeto, uma propriedade ou um método que não está incluído em uma versão mais antiga da API. Atualize a biblioteca de API no ambiente de desenvolvimento.

Se você ainda não encontrou a solução para o problema, entre em contato com o Suporte dos Serviços de Mídia.