A depuração de elementos de mídia HTML, como <video>
e <audio>
, pode ser difícil, já que as implementações do decodificador variam no que consideram erros (os decodificadores de hardware geralmente são os mais rigorosos), especialmente quando uma reprodução pode usar recursos mais esotéricos de um codec específico. Felizmente, há diversas ferramentas que podemos usar para ajudar.
Ao depurar erros de reprodução de mídia, a primeira coisa que geralmente verificamos é o atributo MediaError error
no elemento de mídia HTML. Esse atributo é uma dica de alto nível do que causou o erro de reprodução de mídia. A propriedade MediaError.code
retorna um valor numérico que representa o tipo de erro que ocorreu em um elemento de mídia. A outra propriedade MediaError.message
pode fornecer uma string com algumas informações de diagnóstico do navegador.
const video = document.querySelector('video');
video.addEventListener('error', () => {
console.log('Error code: ' + video.error.code);
console.log('Error message: ' + video.error.message);
});
Essas propriedades são mais úteis para a análise de telemetria e nem sempre fornecem informações suficientes para depurar erros de reprodução. Por motivos de privacidade, o texto completo da mensagem pode ser omitido algumas vezes.
Para acessar informações completas sobre o erro, use o Painel de mídia do Chrome DevTools para conferir os registros de mídia. Você encontrará muitas informações, como eventos, avisos e mensagens de erro, que oferecem boas dicas dos erros de reprodução de mídia.
![Captura de tela do Media Panel no Chrome DevTools](https://web.dev/static/articles/debug-playback-errors/image/screenshot-the-media-pan-96619b7be4c41.png?authuser=5&hl=pt-br)
Também é possível usar o aplicativo sem custo financeiro FFmpeg para verificar a integridade do arquivo de mídia graças a este comando:
ffmpeg -err_detect explode -i <file> -f null -
Confira alguns erros que podem ocorrer com esses comandos em um arquivo de vídeo com codec inválido:
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x7fc62df05380] Could not find codec parameters for stream 0 (Video: none (zzzz / 0x7A7A7A7A), none(smpte170m/smpte170m/bt709, progressive), 320x240, 4 kb/s): unknown codec
Consider increasing the value for the 'analyzeduration' (0) and 'probesize' (5000000) options
[matroska,webm @ 0x7fd45b705380] Unknown EBML doctype '0000'
[matroska,webm @ 0x7f8d17904d40] Element at 0x8b ending at 0x10400000095 exceeds containing master element ending at 0x9b
Truncating packet of size 9069 to 94
O MP4Box.js / ISOBMFF Box Structure Viewer é uma ferramenta útil para depurar problemas de bitstream. Mas, para usá-lo, você já precisa entender o MP4.
Por fim, algumas ferramentas profissionais de análise de stream de vídeo, como VQAnalyzer, Elecard StreamEye e Codecian CodecVisa, podem valer a pena.