Ir para o conteúdo

Solução de problemas

Uma importação falha

Por que um arquivo de mídia é recusado ou falha ao importar, e o que mudar.

Última atualização:

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#

  1. Leia o motivo: o cartão com falha na biblioteca, ou a CLI.
  2. Associe-o à tabela.
  3. Corrija e importe de novo. O mesmo arquivo importado duas vezes não acrescenta nada, porque os originais são guardados por conteúdo.
Terminal
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êCausaCorreção
E_FILE_NOT_FOUND (modo local)o caminho não existeconfira o caminho; cole o caminho absoluto, um navegador não consegue lê-lo de um arquivo solto
E_PATH_NOT_ALLOWEDuma URL, um caminho UNC ou de dispositivo, um caminho relativo, um .., um diretório ou um arquivo que não é comuminforme o caminho absoluto de um arquivo comum nesta máquina
E_PATH_NOT_ALLOWED no modo de redeo arquivo não está dentro de VUKEM_VIDEO_IMPORT_ROOTS, ou não existe: a resposta é a mesma de propósitopeça ao operador que adicione o diretório às raízes de importação
um arquivo maior que 8 GiBVUKEM_VIDEO_MAX_IMPORT_BYTESaumente o limite, ou corte o arquivo antes
mais longo que 4 horasVUKEM_VIDEO_MAX_IMPORT_SECONDSaumente-o, ou corte o arquivo
um quadro maior que 7680 x 4320, ou um lado acima de 8192VUKEM_VIDEO_MAX_IMPORT_PIXELSreduza a escala da origem
E_FFMPEG_MISSINGnenhum FFmpeg utilizávelveja FFmpeg, codecs e licenças
E_ASSET_NOT_READY em uma ediçãoa mídia ainda está em ingestãoespere por ready, depois repita; pode ser repetido
E_RATE_LIMITEDmais de 10 importações por minutoespere o Retry-After
E_QUEUE_FULLingestões demais ao mesmo tempo (VUKEM_VIDEO_MAX_INGESTS)repita em breve
o arquivo termina failed com um motivo de codeco arquivo está danificado ou em um formato que o FFmpeg não consegue lerexporte 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_ALLOWED como um problema de permissões no modo de rede. Ele também esconde se o arquivo existe.

Próximos passos#