Separe o contêiner do codec de vídeo
Um contêiner empacota trilhas, tempo, metadados e índices. Um codec define como uma trilha de vídeo é compactada e decodificada. Renomear um arquivo HEVC de .mov para .mp4 não o transforma em H.264, assim como alterar o nome de um arquivo ZIP não converte os arquivos dentro dele.
MP4 geralmente carrega vídeo H.264, HEVC ou AV1. WebM geralmente carrega VP8, VP9 ou AV1. MOV, MKV e AVI podem conter muitas combinações. O guia de codec de vídeo MDN atual lista relacionamentos comuns de codec e contêiner, mas a reprodução real ainda pode variar de acordo com perfil, profundidade de bits, hardware, licenciamento e versão do navegador.
É por isso que uma lista de extensões só pode descrever entradas prováveis. Um arquivo MP4/H.264 legível pelo navegador é um primeiro teste conservador; nenhuma ferramenta de navegador honesta pode garantir que todos os arquivos que compartilham uma extensão serão decodificados.
Use uma escada de diagnóstico em vez de novas tentativas aleatórias
- Teste a reprodução normal. Abra o arquivo diretamente no mesmo navegador. Se não puder ser reproduzido, a extração de quadros não poderá fazer com que o decodificador o suporte.
- Experimente um arquivo local em bom estado. Um pequeno exemplo de H.264 MP4 ou WebM comum separa um problema de todo o site de um problema específico da origem.
- Teste outro navegador atual no mesmo dispositivo. Navegadores diferentes podem usar caminhos de decodificação diferentes, mesmo em um sistema operacional.
- Teste outro dispositivo ou sistema operacional. Isso é especialmente útil para HEVC e perfis mais recentes com hardware ou suporte de plataforma irregular.
- Inspecione os metadados do stream. Um inspetor de mídia local pode revelar o nome do codec, perfil, nível, formato de pixel, profundidade de bits, dimensões, modo de taxa de quadros e duração.
- Crie um derivado compatível. Transcodifique apenas uma cópia com uma ferramenta local confiável e mantenha o original como fonte de registro.
Reconheça padrões de falha comuns
O navegador diz que o formato não é compatível
O contêiner ou faixa de vídeo principal pode não ter um decodificador disponível. Um formato de croma incomum e de alta profundidade de bits, um perfil avançado ou um limite de licenciamento de codec podem ser importantes mesmo quando a família de codecs parece ser suportada.
A reprodução funciona, mas a busca não é confiável
O arquivo pode ter quadros-chave esparsos, índices incompletos, carimbos de data/hora incomuns ou metadados danificados. A reprodução direta pode ser bem-sucedida porque é decodificada sequencialmente, enquanto o acesso aleatório depende do tempo e das informações de índice.
Os primeiros quadros funcionam e os quadros posteriores falham
Um segmento danificado, carimbos de data/hora descontínuos, pressão de memória ou um erro de decodificação posterior no fluxo podem ser os responsáveis. Tente uma distância menor em torno da falha e compare o comportamento de outro jogador.
O áudio é reproduzido, mas nenhuma imagem aparece
Os contêineres carregam trilhas separadas. O navegador pode oferecer suporte ao codec de áudio, mas não oferece suporte ao codec de vídeo ou ao seu perfil.
URLs remotos adicionam regras de rede às regras de mídia
Uma URL direta deve apontar para a mídia que o navegador pode buscar e decodificar. Uma página de compartilhamento, página de visualização na nuvem, download autenticado ou resposta HTML não é um arquivo de vídeo direto. O servidor remoto também precisa permitir o uso de origem cruzada quando a ferramenta desenha o vídeo em uma tela; caso contrário, as regras de segurança do navegador poderão bloquear a exportação, mesmo que a reprodução pareça possível.
Redirecionamentos, assinaturas expiradas, suporte a intervalo de bytes ausente, proteção de hotlink, cookies de autenticação e erros de tipo de conteúdo podem tornar uma fonte remota menos confiável do que um arquivo local. Baixar um arquivo que você está autorizado a usar e selecioná-lo localmente remove a maioria dessas variáveis de rede.
Quando um URL remoto é usado, o navegador entra em contato diretamente com o host de terceiros. O host pode receber informações de solicitação normais, como endereço IP e cabeçalhos do navegador. A política de privacidade do VideoToImg explica os limites.
Escolha um alvo de compatibilidade conservador
Para um derivado destinado principalmente aos navegadores atuais, o vídeo H.264 em um contêiner MP4 continua sendo uma linha de base amplamente compatível. Uma combinação comum de WebM é outro alvo útil. Mantenha as dimensões e a taxa de quadros apropriadas para a tarefa real; converter uma fonte para uma resolução maior ou uma taxa de quadros mais alta não cria informações visuais ausentes.
Para filmagens privadas, use um conversor local confiável em vez de fazer upload para um serviço desconhecido. Preserve o original separadamente e documente as configurações de conversão quando o tempo ou a fidelidade visual forem importantes. A recodificação apresenta perdas, a menos que um fluxo de trabalho sem perdas seja escolhido deliberadamente; portanto, uma cópia de compatibilidade não deve substituir silenciosamente o mestre de origem.
A documentação dos formatos FFmpeg é uma referência primária para os demuxers e muxers suportados pelo FFmpeg, mas as opções de comando e a disponibilidade do codec dependem da compilação instalada. Este site não executa FFmpeg no navegador e não reivindica cobertura de formato equivalente.
Escreva um relatório de compatibilidade que possa ser reproduzido
Registre o nome e a versão do navegador, o sistema operacional, a extensão do arquivo, o codec e o perfil quando conhecidos, as dimensões, a duração, se a reprodução normal funciona e o ponto exato onde a extração falha. Indique se a fonte era local ou remota e se um pequeno arquivo em bom estado funcionou na mesma sessão.
Não envie um vídeo de fonte privada apenas para provar um bug. Um arquivo de reprodução curto e não confidencial ou metadados completos é mais seguro e geralmente mais útil. Remova nomes de arquivos pessoais, parâmetros de URL assinados e identificadores de contas de capturas de tela ou registros.
Envie relatórios reproduzíveis para hello@videotoimg.com ou abra o conversor de vídeo em imagem para testar um arquivo local legível pelo navegador.