O que você vai aprender#
- como ver por que uma importação falhou;
- as recusas que vêm do caminho, do arquivo e dos limites;
- o que fazer em cada uma.
A ideia#
Uma importação tem duas etapas. Primeiro o servidor confere o caminho e coloca o arquivo na fila: um caminho ruim é recusado na hora. Depois a tarefa de ingestão lê o arquivo com o ffprobe, gera o proxy, as miniaturas e os picos de áudio, e termina no estado ready, ou failed com um motivo. A biblioteca mostra o estado de cada mídia (Aguardando, Importando, Pronta ou Falhou) e uma que falhou tem Tentar de novo.
Início rápido#
- Leia o motivo: o cartão com falha na biblioteca, ou a CLI.
- Associe-o à tabela.
- Corrija e importe de novo. O mesmo arquivo importado duas vezes não acrescenta nada, porque os originais são guardados por conteúdo.
vukem-video media:list --project prj_7k2m9x4q1b
vukem-video media:inspect ast_4h6j8k2m3n --project prj_7k2m9x4q1b --sections probe
vukem-video doctor --full| O que você vê | Causa | Correção |
|---|---|---|
E_FILE_NOT_FOUND (modo local) | o caminho não existe | confira o caminho; cole o caminho absoluto, um navegador não consegue lê-lo de um arquivo solto |
E_PATH_NOT_ALLOWED | uma URL, um caminho UNC ou de dispositivo, um caminho relativo, um .., um diretório ou um arquivo que não é comum | informe o caminho absoluto de um arquivo comum nesta máquina |
E_PATH_NOT_ALLOWED no modo de rede | o arquivo não está dentro de VUKEM_VIDEO_IMPORT_ROOTS, ou não existe: a resposta é a mesma de propósito | peça ao operador que adicione o diretório às raízes de importação |
| um arquivo maior que 8 GiB | VUKEM_VIDEO_MAX_IMPORT_BYTES | aumente o limite, ou corte o arquivo antes |
| mais longo que 4 horas | VUKEM_VIDEO_MAX_IMPORT_SECONDS | aumente-o, ou corte o arquivo |
| um quadro maior que 7680 x 4320, ou um lado acima de 8192 | VUKEM_VIDEO_MAX_IMPORT_PIXELS | reduza a escala da origem |
E_FFMPEG_MISSING | nenhum FFmpeg utilizável | veja FFmpeg, codecs e licenças |
E_ASSET_NOT_READY em uma edição | a mídia ainda está em ingestão | espere por ready, depois repita; pode ser repetido |
E_RATE_LIMITED | mais de 10 importações por minuto | espere o Retry-After |
E_QUEUE_FULL | ingestões demais ao mesmo tempo (VUKEM_VIDEO_MAX_INGESTS) | repita em breve |
o arquivo termina failed com um motivo de codec | o arquivo está danificado ou em um formato que o FFmpeg não consegue ler | exporte o arquivo de novo a partir da origem, ou converta-o para MP4 |
Se o servidor está abaixo de VUKEM_VIDEO_MIN_FREE_BYTES (2 GiB) de espaço livre no volume do espaço de trabalho, as gravações são recusadas até você liberar espaço.
Erros comuns#
- Importar de um compartilhamento de rede ou de uma unidade removível que desaparece: o original é copiado para o espaço de trabalho uma vez, mas uma unidade que se desconecta durante a cópia faz a importação falhar.
- Ler
E_PATH_NOT_ALLOWEDcomo um problema de permissões no modo de rede. Ele também esconde se o arquivo existe.