How to troubleshoot playback errors - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Estratégia de solução de problemas

Nota

O ApsaraVideo Player SDK é atualizado continuamente com novos recursos, melhorias de desempenho e aprimoramentos de estabilidade. Se você encontrar um problema, recomendamos que primeiro verifique se ele foi resolvido na versão mais recente do SDK. Baixe o Player SDK.
Se ocorrer um problema de reprodução, recomendamos que você use primeiro a ferramenta de verificação de URL de reprodução para autodiagnóstico. Essa ferramenta pode diagnosticar rapidamente problemas comuns de reprodução e fornecer soluções. Para obter mais informações, consulte Solucionar problemas de reprodução de vídeo.

A reprodução de vídeo pode falhar por vários motivos. Para identificar a causa, primeiro verifique se os erros seguem um padrão. Se seguirem, use as possíveis causas na tabela a seguir para orientar sua investigação. Se não houver um padrão claro, solucione o problema examinando o dispositivo final, o fluxo de mídia e a rede. Se você ainda não conseguir identificar a causa, entre em contato com o suporte técnico do Alibaba Cloud.

Erros com um padrão de distribuição:

Padrão de erro	Possível causa
A reprodução falha para usuários em redes de provedores de internet ou regiões específicas.	O problema pode ser causado por problemas na rede da operadora local ou por problemas de agendamento de CDN na região.
A reprodução falha em dispositivos finais com sistemas operacionais específicos.	O problema pode ser causado por diferenças na implementação do SDK entre plataformas ou por problemas de compatibilidade do sistema.
A reprodução falha em marcas ou modelos específicos de dispositivos finais.	O problema pode ser causado por problemas de compatibilidade do dispositivo.
A reprodução falha para arquivos de áudio ou vídeo específicos.	O problema pode ser causado por problemas na codificação do arquivo de mídia, no prefetch de CDN ou nas políticas de acesso do negócio.

Erros sem um padrão de distribuição claro: a causa pode ser complexa. Nesse caso, rastreie o fluxo de trabalho do conteúdo até o usuário para identificar o nó problemático e determinar a causa raiz.

Etapa 1: Verifique o dispositivo final

Compatibilidade do dispositivo final

Primeiro, verifique se o protocolo de fluxo de mídia é compatível com o sistema operacional e o ambiente do aplicativo. Caso contrário, você precisará transcodificar o fluxo. Para obter mais informações, consulte Recomendações de transcodificação. As tabelas a seguir listam os protocolos de vídeo e codecs compatíveis com o Player SDK.

Aplicativo nativo

Sistema operacional	Codec de vídeo	Protocolo de vídeo	Codec de áudio
Android	H.264 H.265	MP4 HLS FLV MPEG-DASH (SegmentBase e SegmentTemplate)	AAC MP3
iOS
Windows
macOS
Linux

Web

Nota

Se o protocolo de fluxo de mídia atender aos requisitos de compatibilidade da web abaixo, verifique se você possui um certificado SSL e se ativou o acesso de origem cruzada. Para obter mais informações, consulte Ativar aceleração segura de HTTPS e Configurar acesso de origem cruzada.

Sistema operacional	Codec de vídeo	Protocolo de vídeo	Codec de áudio
Android	H.264	MP4 HLS (Parcialmente compatível. Alguns navegadores requerem MSE. Consulte a tabela abaixo para obter detalhes.) FLV (Requer MSE)	AAC MP3
iOS	H.264	MP4 HLS Nota FLV e MPEG-DASH não são compatíveis.
iOS	H.265	MP4 HLS (segmentos fMP4 necessários)
Windows	H.264	MP4 HLS (Requer MSE) FLV (Requer MSE)
macOS	H.264	MP4 HLS FLV (Requer MSE)
macOS	H.265	MP4 HLS (segmentos fMP4 necessários)

Alguns navegadores em dispositivos Android requerem MSE para reproduzir vídeos HLS. Os detalhes são os seguintes:

Navegador em dispositivos Android	Suporte a HLS
WeChat	Compatível
DingTalk	Compatível
UC/Quark	Compatível
QQ Browser	Compatível
Chrome	Requer MSE
Huawei Browser	Requer MSE
OPPO Browser	Compatível
vivo Browser	Compatível
Mi Browser	Requer MSE

Compatibilidade do Player SDK

Se o seu dispositivo atender aos requisitos de compatibilidade, use um player diferente para verificar se o problema está relacionado à compatibilidade do ApsaraVideo Player SDK.

Se o vídeo for reproduzido corretamente em outro player, o problema pode estar no ApsaraVideo Player SDK. Nesse caso, entre em contato com o suporte técnico.
Se o vídeo também não for reproduzido em outro player, você precisará verificar o fluxo de mídia e a rede.

Recomendamos o uso dos seguintes players para solução de problemas:

Player de terceiros: VLC
Player do sistema: ExoPlayer (Android), AVPlayer (iOS)
Navegador do sistema (apenas Web): Chrome (Android, Windows), Safari (iOS, macOS)

Etapa 2: Verificar o fluxo de mídia

Após descartar as causas anteriores, transcodifique o fluxo de mídia e tente reproduzi-lo novamente. Se a reprodução for bem-sucedida, é provável que o fluxo original tenha sido codificado incorretamente.

Nota

Os vídeos MP4 podem iniciar lentamente ou os vídeos MOV podem falhar na reprodução se o átomo moov (índice de dados de mídia) estiver localizado após o átomo mdat (dados de mídia). Transcodificar o vídeo de origem para mover o átomo moov para antes do átomo mdat pode acelerar a análise da reprodução.

Use o seguinte comando para verificar a posição do átomo moov:

Input #0, mov, mp4, m4a, 3gp, 3g2, mj2, from 'input.mp4':
    Metadata:
      major_brand     : isom
      minor_version   : 512
      compatible_brands: isomiso2avc1mp41
      encoder         : www.aliyun.com - Media Transcoding
    Duration: 00:00:17.56, start: 0.000000, bitrate: 3088 kb/s
    Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p, 1440x2560, 2890 kb/s, 25 fps, 25 tbr, 12800 tbn, 50 tbc (default)
      Metadata:
        handler_name    : VideoHandler
    Stream #0:1(und): Audio: aac (LC) (mp4a / 0x6134706D), 44100 Hz, stereo, fltp, 191 kb/s (default)
      Metadata:
        handler_name    : SoundHandler

Em um cenário normal, o átomo moov vem antes do átomo mdat, o que indica uma otimização faststart. A saída de exemplo é mostrada abaixo.

Input #0, mov, mp4, m4a, 3gp, 3g2, mj2, from 'input.mp4':
    Metadata:
      major_brand     : isom
      minor_version   : 512
      compatible_brands: isomiso2avc1mp41
      encoder         : www.aliyun.com - Media Transcoding
    Duration: 00:00:17.56, start: 0.000000, bitrate: 3088 kb/s
    Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p, 1440x2560, 2890 kb/s, 25 fps, 25 tbr, 12800 tbn, 50 tbc (default)
      Metadata:
        handler_name    : VideoHandler
    Stream #0:1(und): Audio: aac (LC) (mp4a / 0x6134706D), 44100 Hz, stereo, fltp, 191 kb/s (default)
      Metadata:
        handler_name    : SoundHandler

Em um cenário anormal, o átomo moov vem depois do átomo mdat.

Input #0, mov, mp4, m4a, 3gp, 3g2, mj2, from 'input.mp4':
    Metadata:
      major_brand     : isom
      minor_version   : 512
      compatible_brands: isomiso2avc1mp41
      encoder         : www.aliyun.com - Media Transcoding
    Duration: 00:00:17.56, start: 0.000000, bitrate: 3088 kb/s
    Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p, 1440x2560, 2890 kb/s, 25 fps, 25 tbr, 12800 tbn, 50 tbc (default)
      Metadata:
        handler_name    : VideoHandler
    Stream #0:1(und): Audio: aac (LC) (mp4a / 0x6134706D), 44100 Hz, stereo, fltp, 191 kb/s (default)
      Metadata:
        handler_name    : SoundHandler

Use o seguinte comando ou a ferramenta de linha de comando ffprobe (ferramenta ffprobe) para consultar informações como o codec de áudio e o codec de vídeo do arquivo de origem. Isso ajuda a analisar se os vídeos com problemas compartilham algum padrão:

ffprobe "input.mp4" ou ffprobe "source_video_url"

Input #0, mov, mp4, m4a, 3gp, 3g2, mj2, from 'input.mp4':
    Metadata:
      major_brand     : isom
      minor_version   : 512
      compatible_brands: isomiso2avc1mp41
      encoder         : www.aliyun.com - Media Transcoding
    Duration: 00:00:17.56, start: 0.000000, bitrate: 3088 kb/s
    Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p, 1440x2560, 2890 kb/s, 25 fps, 25 tbr, 12800 tbn, 50 tbc (default)
      Metadata:
        handler_name    : VideoHandler
    Stream #0:1(und): Audio: aac (LC) (mp4a / 0x6134706D), 44100 Hz, stereo, fltp, 191 kb/s (default)
      Metadata:
        handler_name    : SoundHandler

Recomendações de transcodificação

Saída de transcodificação: Recomendamos a transcodificação para um fluxo de vídeo H.264 MP4 ou HLS.

Método de transcodificação: Recomendamos o uso dos seguintes serviços da Alibaba Cloud ou ferramentas locais.

Categoria	Serviço ou ferramenta	Descrição
Serviço da Alibaba Cloud	ApsaraVideo VOD	O ApsaraVideo VOD oferece recursos abrangentes de transcodificação e transmuxing para atender a várias necessidades de conversão de formato de mídia. Ele suporta transcodificação padrão, Narrowband HD 1.0, Narrowband HD 2.0 e transcodificação com qualidade de origem. Para obter mais informações, consulte Transcodificação de áudio e vídeo.
	ApsaraVideo Media Processing (MPS)	O ApsaraVideo Media Processing (MPS) transcodifica dados multimídia em formatos adequados para reprodução em todas as plataformas. Ele suporta transcodificação padrão, Narrowband HD 1.0, Narrowband HD 2.0, transcodificação de alta velocidade e transcodificação com duplicação de resolução. Isso é ideal para usuários que armazenam arquivos de vídeo de origem em seus próprios buckets do OSS. Para obter mais informações, consulte Transcodificação de mídia.
	Intelligent Media Services (IMS)	O Intelligent Media Services (IMS) oferece recursos de transcodificação sob demanda e transcodificação em tempo real. Ele suporta a transcodificação de mídia armazenada no OSS ou no ApsaraVideo VOD, bem como a transcodificação de transmissões ao vivo.
Ferramenta local	FFmpeg Codecs	Baixe em: FFmpeg Codecs

Etapa 3: Verificar a rede

Se as etapas anteriores não resolveram o problema, verifique a transmissão de rede para localizar a causa do erro de reprodução.

Verifique se o dispositivo final tem uma conexão de rede estável.
- Wi-Fi: A rede atual está estável e acessível? A velocidade de download da rede é maior ou igual à taxa de bits do vídeo?
  
  Você pode usar o Speedtest.net para verificar a velocidade de download da rede. Se a velocidade for menor que a taxa de bits do vídeo, podem ocorrer falhas de carregamento ou travamentos na reprodução.
- Rede móvel: O dispositivo está conectado a uma rede de alta velocidade, como 4G ou 5G? Qual é a força do sinal?
  
  Em condições de rede fraca, a velocidade pode não ser suficiente para carregar fluxos de mídia.
Nota
Se você sofrer sequestro de DNS, configure manualmente seu DNS para o DNS público do Alibaba Cloud (223.5.5.5, 223.6.6.6) para restaurar a reprodução.
1. Acesse Configurações > Wi-Fi no seu dispositivo móvel.
2. Toque no botão de detalhes à direita da sua rede atual para abrir a página de detalhes da rede.
3. Configure o DNS.
  
  Na página de configuração de rede, você encontrará três seções: Endereço IP (sub-rede, gateway), Endereço IPv6 (endereço IP, gateway) e DNS. Toque na seta ao lado da entrada DNS para acessar a configuração detalhada.
Verifique se a aceleração de CDN está ativada.
- Se a aceleração de CDN não estiver ativada, recomendamos configurá-la para melhorar a experiência de reprodução. Para mais informações, consulte Adicionar um nome de domínio acelerado.
- Se a aceleração de CDN estiver ativada:
  - Problema de configuração de CDN: O conteúdo de mídia foi pré-buscado? O cache de conteúdo expirou?
    
    Uma falha de cache de CDN, causada por conteúdo que não foi pré-buscado ou por um cache expirado, pode levar a falhas de carregamento ou travamentos na reprodução. Esse problema é comum em vídeos recém-enviados. Recomendamos pré-buscar ativamente o conteúdo de novos vídeos. Para mais informações, consulte Atualizar e pré-buscar recursos.
  - Outros problemas: Os vídeos de outros aplicativos são reproduzidos normalmente no mesmo dispositivo final?
    
    Se o CDN estiver configurado corretamente e outros aplicativos reproduzirem vídeos sem problemas, o erro de reprodução pode ser causado por um problema localizado de agendamento de CDN.
Verifique as localizações do servidor de origem e dos seus usuários finais.

Se o servidor de origem estiver na China continental e os usuários estiverem no exterior, podem ocorrer travamentos significativos. Nesse caso, implante o servidor de origem em uma região mais próxima dos seus usuários para melhorar o desempenho.
Verifique os horários de pico de visualização.

Se muitas pessoas estiverem assistindo ao mesmo tempo, o servidor de origem pode limitar o tráfego, causando travamentos na reprodução.

A reprodução falha após a configuração de um nome de domínio acelerado

Se os vídeos não forem reproduzidos após você configurar um nome de domínio acelerado, solucione problemas nos seguintes itens:

Verifique o status de resolução do CNAME
- No console do VOD, acesse Gerenciamento de Domínios e verifique se a coluna CNAME mostra o nome de domínio como ativado.
- Alternativamente, execute o comando nslookup ou dig para verificar se o nome de domínio resolve para um nó de CDN.
Verifique a configuração do certificado HTTPS
- Na página Gerenciamento de Domínios, abra a configuração do domínio e verifique o status do certificado HTTPS.
- Se nenhum certificado estiver configurado ou se o certificado tiver expirado, os players em ambientes HTTPS recusarão o carregamento do fluxo de mídia.
Verifique a proteção contra hotlink baseada em Referer e a configuração de assinatura de URL
- Verifique as configurações de listas negras e listas brancas de Referer na configuração do domínio.
- Verifique as configurações de assinatura de URL e certifique-se de que o tipo e os parâmetros de assinatura correspondam à solicitação de reprodução.
Verifique o status de pré-busca de CDN
- Acesse Atualizar e Pré-buscar e verifique o status das tarefas de pré-busca.
- A primeira reprodução de um vídeo que não foi pré-buscado pode ser lenta para carregar ou atingir o tempo limite.
Solução de recuperação temporária
- Na página Gerenciamento de Domínios, desative o nome de domínio acelerado e reative-o após a causa ser identificada.

Documentos relacionados

Se você ainda não conseguir identificar a causa após seguir as etapas anteriores, consulte os seguintes documentos para casos e soluções semelhantes:

Contate o suporte técnico

Se o problema persistir, envie um ticket. Para mais informações sobre como enviar um ticket, consulte Fale conosco.

Para nos ajudar a resolver seu problema de forma eficiente, forneça as seguintes informações no seu ticket.

Item	Exemplo	Descrição
Sistema operacional e plataforma do dispositivo	Android 9, Xiaomi	Forneça a marca do dispositivo e a versão do sistema operacional, por exemplo: Xiaomi com Android 9, iOS 15, Windows 11 ou macOS 12.
SDK e versão	Android SDK 5.4.8.0	Especifique o Player SDK que você está usando e seu número de versão. Os Player SDKs incluem o Web SDK, Android SDK, iOS SDK, Flutter SDK e Windows SDK.
Fonte do vídeo	https://xxxxxx.m3u8	Forneça a URL da fonte do vídeo ou o arquivo de vídeo que reproduz o problema.
Descrição do problema, logs e gravação de tela	A reprodução começou às 16:40 em 29 de agosto de 2022, e ocorreram travamentos por volta das 17:00. O log está anexado.	Descreva as etapas de reprodução e os sintomas observados em detalhes, incluindo carimbos de data/hora específicos. Para problemas reproduzíveis, forneça um log completo das etapas de reprodução. Para obter informações sobre como obter logs, consulte Obter logs no Android ou Obter logs no iOS. Se necessário, anexe uma gravação de tela.
Padrão de erro	O problema ocorre apenas em dispositivos Android, não em iOS. É sempre reproduzível.	Descreva se o problema segue um padrão específico e sua frequência. Por exemplo, especifique se o problema está limitado a uma determinada fonte de vídeo, plataforma de dispositivo ou versão do SDK, e se é intermitente ou sempre reproduzível.