O envio de vídeo diz “formato não compatível”? Diagnostique a falha
Diagnostique envios de vídeo não compatíveis separando tamanho, contêiner, codecs e estado do navegador, com matriz mínima de testes e modelo de suporte.
Um erro de “formato não compatível” ao enviar vídeo não é necessariamente um problema de tamanho de arquivo. Identifique quando a falha ocorre, inspecione o contêiner e os fluxos reais de vídeo e áudio e teste uma cópia pequena e representativa em relação aos requisitos documentados do destino. Mude um fator de cada vez para que uma tentativa bem-sucedida informe algo útil.
Não comece comprimindo repetidamente o mesmo arquivo. Um arquivo menor ainda pode conter um codec não aceito, um fluxo de áudio incompatível ou mídia danificada. Um arquivo perfeitamente válido também pode falhar por problemas de navegador, conta, rede ou estado de processamento. A mensagem de erro é um ponto de partida, não um diagnóstico completo.
O fluxo abaixo usa um caso construído de envio e uma matriz de testes proposta. Nenhuma falha real de envio a serviços nem controle bem-sucedido na Recapo foi testado para esse exemplo.
Registre a falha antes de alterar o arquivo
Anote a mensagem exata, a etapa em que apareceu e se o serviço criou uma tarefa ou salvou um envio. Preserve o arquivo original e dê um nome diferente a cada cópia de diagnóstico.
Vale separar três etapas. O navegador pode rejeitar a seleção antes da transferência. A transferência pode parar antes de terminar. Ou o serviço pode aceitar os bytes e falhar durante o processamento da mídia. Essas observações apontam para verificações diferentes, mesmo quando o erro exibido usa termos parecidos.
Não deduza que uma tela de falha significa que nenhuma tarefa existe. Confira os históricos ou as visualizações de status disponíveis, se houver, antes de enviar o mesmo arquivo novamente. Se o estado de uma operação paga estiver incerto, esclareça-o pelo caminho disponível de status ou suporte em vez de reenviar sem verificar.
Registre contexto suficiente para reproduzir o problema: recurso de destino, versões do navegador e sistema operacional, extensão do arquivo, tamanho aproximado e horário da tentativa. Não inclua senhas, tokens de sessão, links privados nem material pessoal desnecessário em um relatório de suporte.
Uma captura de tela pode preservar a redação, mas copie também o texto, se possível. Uma nota vaga como “não funcionou” perde a distinção entre rejeição, transferência interrompida e falha de processamento.
Um arquivo de vídeo tem mais de uma camada de compatibilidade
Diagrama conceitual; não é uma captura da interface do produto.
A extensão do nome não é uma especificação completa. Um contêiner empacota fluxos e metadados; codecs descrevem como os fluxos individuais de mídia são codificados. Um destino pode aceitar um contêiner e rejeitar algo dentro dele.
Por exemplo, dois arquivos terminados em .mp4 não precisam conter o mesmo codec de vídeo, codec de áudio, perfil, formato de pixels ou organização de fluxos. Renomear uma extensão não altera esses conteúdos.
Inspecione as camadas relevantes para o destino:
| Camada | O que registrar | Por que pode importar |
|---|---|---|
| Contêiner | Formato real, não apenas a extensão | Determina como os fluxos e as informações de temporização são empacotados |
| Vídeo | Codec, perfil quando disponível, dimensões, formato de pixels/profundidade de bits | Um decodificador pode aceitar apenas parte das possibilidades de um codec |
| Áudio | Codec, quantidade/configuração de canais, taxa de amostragem, pista selecionada | Vídeo aceito não implica que todos os fluxos de áudio sejam aceitos |
| Temporização | Duração, tempos iniciais, comportamento da taxa de quadros | A importação ou o processamento pode falhar em determinada estrutura de temporização |
| Fluxos extras | Legendas, áudio alternativo, anexos, dados | O destino pode não esperar nem preservar esses itens |
| Integridade do arquivo | Se é possível ler o arquivo inteiro | Um cabeçalho plausível não prova que a mídia esteja completa |
Nem todo campo estará disponível em uma interface simples. Registre o que consegue inspecionar e identifique as informações ausentes. Não preencha valores desconhecidos com suposições baseadas no dispositivo ou na extensão.
Use os requisitos oficiais atuais do destino para determinar o que importa. Uma recomendação genérica como “use MP4” não substitui as especificações reais de vídeo e áudio aceitos.
Localize a falha com uma árvore simples de decisão
Diagrama conceitual; não é uma captura da interface do produto.
Se a seleção for rejeitada imediatamente, confira o tipo de entrada documentado, a extensão, os limites de tamanho e duração e se o recurso escolhido aceita esse tipo de fonte. Não suponha que os limites de outra ferramenta do mesmo site se apliquem.
Se a transferência começar e parar, preserve o erro e inspecione a conexão, o estado do navegador e qualquer status de envio fornecido pelo serviço. Uma conversão de formato pode não resolver uma falha de transporte.
Se o envio terminar, mas o processamento falhar, inspecione os fluxos de mídia e a leitura local. O serviço pode conseguir receber o contêiner sem conseguir decodificar os fluxos selecionados.
Se o arquivo for processado, mas ficar sem som, com orientação errada, pistas ausentes ou cor alterada, o problema deixa de ser simplesmente “falha de envio”. É necessária uma verificação de preservação do conteúdo e interpretação. Uma mensagem verde de sucesso não prova que o vídeo entregue seja aceitável.
Use essas possibilidades para escolher uma próxima observação. Não limpe os dados do navegador, transcodifique o arquivo, troque de rede e crie uma conta nova ao mesmo tempo. Mesmo que a próxima tentativa funcione, você não saberá qual fator importou.
Confira o original localmente antes de criar variantes
Abra o original completo em um reprodutor ou editor local adequado e inspecione início, meio e fim. Confirme que o áudio esperado está presente, a duração é plausível e o arquivo não para inesperadamente.
A reprodução local bem-sucedida delimita o problema, mas não estabelece compatibilidade com o destino. Um aplicativo local pode aceitar codecs ou combinações de fluxos que o serviço não aceita. Por outro lado, a falha em um reprodutor pode refletir o suporte desse reprodutor, não corrupção.
Se a mídia parecer truncada, compare o tamanho e o histórico de transferência com a melhor fonte disponível. Um arquivo parcialmente copiado deve ser recuperado da fonte, quando possível, não transcodificado repetidamente na esperança de que o conteúdo ausente volte.
Use uma ferramenta técnica de inspeção, se necessário, para identificar os fluxos. Guarde uma cópia do relatório com o registro de diagnóstico. Não suponha que um único campo exibido como “formato” cubra o contêiner e todos os codecs.
Escolha o teste menos transformador que responda à pergunta
O FFmpeg distingue cópia de fluxos de transcodificação. A cópia leva os fluxos codificados selecionados para uma saída sem recodificá-los; a transcodificação decodifica e codifica. Sua documentação de seleção de fluxos também deixa claro que a seleção determina o que chega à saída. Documentação do FFmpeg
Essa distinção ajuda a escolher um teste. Se os fluxos atenderem aos requisitos do destino, mas o contêiner não, um remux compatível pode bastar. Se o codec de vídeo não for aceito, apenas reempacotá-lo não criará um codec aceito.
Não chame remux de universalmente sem perdas em todos os sentidos. Evitar recodificação preserva a mídia comprimida selecionada, mas a saída ainda pode diferir em metadados, timestamps ou fluxos incluídos. Confira o que foi mantido.
Se a transcodificação for necessária, comece pela melhor fonte e escolha configurações adequadas ao destino. Evite uma cadeia de cópias com perdas feitas a partir de saídas de testes anteriores. Dê uma finalidade a cada teste e mantenha o original.
Um comando externo que ilustra um remux seletivo, somente após confirmar que os fluxos escolhidos podem ser armazenados em MP4, é:
ffmpeg -n -i "sample.mov" -map 0:v:0 -map "0:a:0?" -c copy "sample-remux.mp4"
Ele seleciona o primeiro vídeo e, se houver, o primeiro fluxo de áudio. Não preserva todos os fluxos extras. A opção que impede sobrescrever evita substituir um destino existente. O comando não é uma correção universal nem uma instrução de interface da Recapo.
Se o codec selecionado for incompatível com o contêiner ou o destino, pare e escolha uma conversão adequada em vez de mudar extensões ou repetir o mesmo comando sem alterações.
Crie uma amostra representativa sem esconder o defeito
Uma amostra pequena pode reduzir o custo de um teste de diagnóstico, mas a forma de criá-la importa. Se a criação da amostra recodificar o vídeo em outro codec, seu sucesso não estabelecerá que o codec original era aceitável.
Documente se a amostra preserva as características originais dos fluxos ou se as altera intencionalmente. Se a falha ocorrer perto do fim, inclua essa região. Se depender de uma transição ou de determinada pista de áudio, preserve essa característica.
Uma amostra apenas do início pode deixar passar danos ou timestamps incomuns no restante do arquivo. Portanto, a amostra testa uma hipótese, não garante que o arquivo completo passará. Depois de identificar uma possível opção, valide uma saída completa antes da entrega.
Para material sensível, use o mínimo de conteúdo autorizado necessário ao diagnóstico. Um arquivo de controle genérico pode testar se o caminho de envio funciona, mas não reproduz todas as propriedades da fonte. Não envie material privado para um serviço sem relação com a tarefa só porque é conveniente para testar.
Exemplo: um arquivo pequeno que ainda falha
Considere Dana, uma pessoa fictícia que presta consultoria, cuja gravação de tela é pequena o suficiente para o limite declarado do destino, mas recebe uma mensagem de formato não compatível após a transferência. O nome termina em .webm. Dana presume que o serviço precisa de um arquivo menor e se prepara para comprimi-lo novamente.
Em vez disso, Dana registra a etapa da falha e inspeciona o arquivo. Neste cenário construído, suponha que o vídeo seja VP9 e o áudio Opus. São detalhes hipotéticos do caso, não constatações de um arquivo realmente enviado.
A próxima pergunta é se os requisitos documentados do destino aceitam essa combinação. Se exigirem outro codec de vídeo ou áudio, reduzir a taxa de bits dos mesmos fluxos não responderá ao problema de compatibilidade.
Dana cria um plano de testes:
| Teste | Mudança deliberada | Observação a registrar | O que um resultado bem-sucedido sustentaria |
|---|---|---|---|
| Controle simples autorizado | Outro arquivo curto que se sabe ser aceito | Seleção, transferência e processamento terminam? | O caminho funciona para esse controle, não necessariamente para a fonte |
| Amostra representativa da fonte | Duração reduzida com propriedades registradas | A mesma falha ocorre? | Se uma unidade representativa menor reproduz o problema |
| Candidato apenas de contêiner | Reempacotar fluxos selecionados compatíveis | O comportamento de processamento muda? | O contêiner/empacotamento pode ser relevante |
| Candidato com codecs de destino | Codificar segundo os requisitos documentados de vídeo/áudio | O arquivo é processado e preserva o conteúdo? | A opção de codificação testada pode servir a esse destino |
| Saída candidata completa | Aplicar a opção aceita ao original | Verificações de processamento completo e conteúdo | A entrega real, não apenas a amostra, passa na revisão |
A tabela não relata resultados concluídos. Ela mostra como interpretar observações futuras sem exagerar as conclusões.
Se a amostra com codecs de destino funcionar, mas a saída completa falhar, Dana não deve declarar o problema resolvido. Inspecione diferenças como duração, danos posteriores, alterações de fluxos ou limites de processamento. Se até o controle simples falhar, investigue o caminho de envio antes de criar mais variantes de mídia.
Saiba em que um transcodificador pode ajudar de forma razoável
O transcodificador H.264 da Recapo descreve publicamente a conversão de fontes como HEVC e VP9 para H.264, com opções de taxa de bits e resolução. Isso pode ser relevante quando H.264 fizer parte da especificação aceita pelo destino.
A descrição pública não comprova todos os controles avançados de seleção de fluxos, codificação de áudio, perfil, timestamps, HDR ou diagnóstico de envio pelo navegador. Use as opções disponíveis se atenderem ao requisito; use um editor ou transcodificador externo documentado quando os controles necessários não estiverem disponíveis.
Não transforme o posicionamento geral de compatibilidade do produto em uma promessa de que qualquer fonte funcionará em qualquer lugar. O destino ainda determina o que aceita, e um arquivo pode ter problemas sem relação com o codec de vídeo.
Após a conversão, verifique áudio, duração, orientação, cor e pistas necessárias. A identificação H.264, sozinha, não estabelece o contrato completo de entrega.
Diferencie um problema de navegador de um problema de mídia
Use uma comparação limpa, não uma coleção de palpites. Experimente o mesmo controle autorizado em outro navegador ou ambiente aceito somente quando isso estiver no escopo da tarefa. Registre as versões e o resultado.
Se um navegador falhar antes da transferência e outro aceitar o mesmo arquivo, isso aponta para o caminho do cliente. Não prova que o processamento final do arquivo funcionará. Se ambos enviarem, mas o serviço rejeitar o processamento, trocar de navegador pode não resolver a incompatibilidade da mídia.
Confira se uma extensão do navegador, sessão expirada ou restrição local pode afetar o caminho, mas não desative proteções indiscriminadamente. Prefira um ambiente aprovado e com mudanças mínimas. Não compartilhe cookies de sessão nem tokens de autenticação com o suporte.
Se o destino relatar um problema de conta ou cota, trate-o como tal. Recodificar o mesmo arquivo não fornece uma autorização de conta ausente. Da mesma forma, não deduza que uma tarefa paga falhou sem consequências apenas porque uma aba do navegador parou de responder.
Evite falsas vitórias
Um envio bem-sucedido com áudio ausente não é uma entrega bem-sucedida. Uma amostra convertida com boa aparência, mas sem legendas, ainda pode não atender aos requisitos do usuário. Um arquivo aceito após redimensionamento agressivo pode ser inadequado para a apresentação pretendida.
Defina os critérios de aceitação antes de escolher o teste. Para um tutorial simples com fala, eles podem incluir a imagem completa, a pista pretendida de narração, texto legível da interface e duração correta. Uma entrega multilíngue pode exigir várias pistas ou um pacote separado de legendas que uma conversão básica não preserva.
Confira a saída real, não apenas as configurações da fonte. Inspecione quais fluxos estão presentes e reproduza pontos representativos. Quando informações importantes estiverem no texto da tela, revise-o no tamanho de entrega.
Se a opção só funcionar após remover uma característica necessária, informe essa concessão em vez de escondê-la. A próxima decisão pode ser outro formato ou fluxo de entrega, não mais compressão.
Um relatório de suporte que permita continuar o diagnóstico
RELATÓRIO DE FALHA DE ENVIO
Recurso de destino e tarefa pretendida:
Texto exato do erro:
Etapa da falha: seleção / transferência / processamento / reprodução entregue
Horário da tentativa e identificador não sensível de tarefa, se houver:
Estado atual da tarefa verificado:
Procedência da fonte original:
Contêiner e extensão do nome:
Codec/perfil/formato de pixels/dimensões do vídeo:
Codec/canais/taxa de amostragem do áudio:
Duração e tamanho do arquivo:
Fluxos extras que precisam ser mantidos:
Constatações da reprodução local:
Testes de controle/amostra e uma variável alterada por teste:
Resultado esperado:
Resultado real:
Capturas de tela ou relatórios de mídia sem informações sensíveis:
O que continua desconhecido:
Não anexe material confidencial de origem a menos que seja necessário, autorizado e enviado por um canal adequado. Um relatório de mídia sem informações sensíveis e uma amostra reproduzível mínima podem bastar para começar.
Antes de encerrar o problema, confirme que a entrega completa é processada, reproduz corretamente, preserva os fluxos e a duração necessários e atende aos requisitos reais do destino. Guarde a opção aceita para conferir o próximo arquivo em relação a ela, sem presumir que todas as fontes futuras sejam iguais.
Para perguntas mais amplas antes de depender de um serviço, consulte a lista de ferramentas de vídeo on-line. O princípio específico aqui é diagnosticar a camada que falha com o menor experimento útil.
Comece anotando a etapa exata da falha e inspecionando os fluxos reais. Essas duas observações costumam tornar o próximo teste mais informativo do que outro arquivo menor com o mesmo conteúdo desconhecido.
