Ir para o conteúdo

Guia de edição

Exportação

Renderize um projeto em um arquivo MP4, GIF, WAV ou AAC, espere por ele e encontre o arquivo verificado.

Última atualização:

O que você vai aprender#

  • como iniciar uma exportação e acompanhá-la;
  • o que precisa ser verdade antes de uma exportação ser aceita.

A ideia#

Uma exportação é uma tarefa. Ela renderiza a revisão atual, codifica um MP4 com o FFmpeg e verifica o arquivo (streams, duração, dimensões, formato de pixel e faststart) antes de marcar a tarefa como succeeded. Um arquivo que falha na verificação nunca é informado como pronto.

A exportação é recusada enquanto a verificação encontrar um erro, com E_LINT_BLOCKING e os primeiros achados. Avisos nunca bloqueiam.

Início rápido#

Terminal
vukem-video lint --project prj_7k2m9x4q1b
vukem-video export --project prj_7k2m9x4q1b

A CLI espera pela tarefa. Use --no-wait para voltar na hora e vukem-video job:show <job id> --wait depois.

O resultado de uma exportação concluída traz o caminho do arquivo em <workspace>/exports/<project id>/<job id>.<extension>, o seu tamanho e a sua duração.

Formatos#

Uma exportação é um MP4, a menos que você escolha outro formato com --format (CLI) ou args.format (MCP e API HTTP).

FormatoArquivoO que é
mp4.mp4vídeo H.264 e áudio AAC (o padrão); precisa de um codificador H.264
gif.gifos quadros compostos, sem áudio; não precisa de codificador
wav.wava mixagem de áudio em PCM de 16 bits, 48 kHz, estéreo
aac.m4aa mesma mixagem em AAC dentro de um contêiner MP4
Terminal
vukem-video export --project prj_7k2m9x4q1b --format gif

Com MCP: job_start com {"project_id": "prj_7k2m9x4q1b", "kind": "export", "args": {"format": "wav"}}.

Troque uma linha do tempo com o OpenTimelineIO#

O otio:export grava a linha do tempo de um projeto como um arquivo OpenTimelineIO, para abri-lo em outro editor. Ele grava o arquivo na máquina que executa o comando, na pasta atual como <project name>.otio, ou onde --out indicar; ele se recusa a substituir um arquivo, a menos que você acrescente --force. O comando lista o que o formato não consegue carregar (por exemplo, efeitos), para que nada se perca em silêncio.

Terminal
vukem-video otio:export --project prj_7k2m9x4q1b --out cut.otio
vukem-video otio:import cut.otio --project prj_7k2m9x4q1b --dry-run
vukem-video otio:import cut.otio --project prj_7k2m9x4q1b --base-revision 12

O otio:import lê um arquivo da máquina que roda o servidor e o aplica ao projeto como um único lote, então um undo o reverte. A taxa de quadros do arquivo precisa ser a do projeto. A mídia do arquivo nunca é aberta: uma referência é associada pelo nome a uma mídia que já está no projeto, e as que não correspondem a nada são listadas como não resolvidas. O --dry-run mostra o que mudaria; o --base-revision assume a revisão atual por padrão. A API HTTP tem GET e POST /api/v1/projects/{id}/otio. Não há ferramenta MCP para o OpenTimelineIO.

Exporte um pacote de projeto#

Um pacote é um único arquivo, <name>.vvbundle, que guarda um projeto e tudo de que ele precisa, para fazer uma cópia de segurança ou entregá-lo a outra pessoa. É um zip com o documento do projeto, a mídia original, as fontes que o projeto usa e, a menos que você a deixe de fora, o registro de operações com o histórico de edições. Proxies, miniaturas e transcrições não são incluídos; eles são gerados de novo quando o pacote é aberto.

Terminal
vukem-video bundle:export --project prj_7k2m9x4q1b --wait
vukem-video bundle:export --project prj_7k2m9x4q1b --no-log --wait

Como uma exportação, um pacote é uma tarefa: o --wait a acompanha, e o arquivo é gravado em <workspace>/exports/<project id>/ como bundle-r<revision>-<job id>.vvbundle. O --no-log deixa o histórico de fora, o que esconde quem editou e por quê. Um projeto na lixeira não pode ser exportado. O comando roda na máquina que possui o espaço de trabalho.

Importe um pacote de projeto#

O bundle:import cria um projeto a partir de um arquivo .vvbundle. Ele lê o arquivo na máquina que roda o servidor, confere-o antes de mudar qualquer coisa e copia para o espaço de trabalho a mídia e as fontes que ele traz. O projeto abre na hora; suas mídias aparecem como em ingestão enquanto os proxies, as miniaturas e as transcrições são gerados de novo.

Terminal
vukem-video bundle:import launch-teaser.vvbundle
vukem-video bundle:import launch-teaser.vvbundle --as-new
vukem-video bundle:import launch-teaser.vvbundle --dry-run

Sem --as-new, o projeto mantém o seu id e o seu histórico de edições. Se já existe um projeto com esse id, mesmo na lixeira, a importação é recusada com E_ID_EXISTS. Com --as-new, o projeto recebe um id novo e começa na revisão 1 sem histórico, porque o histórico de outro projeto não pertence a um projeto novo. Um servidor com contas exige --as-new. O --dry-run confere o arquivo e informa o que seria criado. Um arquivo danificado, grande demais, de formato diferente ou vindo de uma versão mais nova do produto é recusado com E_VALIDATION e um motivo, e nada é importado. A API HTTP tem a mesma operação como POST /api/v1/projects/import.

Não há ferramenta MCP para pacotes e o editor ainda não tem uma entrada para pacotes.

Erros comuns#

  • Nenhum codificador H.264 funciona nesta máquina: E_NO_ENCODER. gif, wav e aac ainda são exportados.
  • Importar um pacote cujo id de projeto já existe: E_ID_EXISTS. Use --as-new.
  • Exportações demais ao mesmo tempo: E_QUEUE_FULL, que pode ser repetido. VUKEM_VIDEO_MAX_EXPORTS define o limite.

Próximos passos#