CLI Packager: comandos e recuperação

Abrir o CLI #

Baixe e extraia o pacote completo Windows Suíte de Conteúdo de pacote. Abra PowerShell na pasta extraída. Os comandos abaixo assumem que os binários FFmpeg, FFprobe e Shaka fornecidos estão ao lado de drmx-packager.exe.

.\drmx-packager.exe version
.\drmx-packager.exe help
.\drmx-packager.exe credentials list
.\drmx-packager.exe credentials test --profile "Production"

Primeiro crie o perfil Production em Desktop Packager, ou substitua esse nome por seu próprio perfil salvo. Use preview.6 ou mais recente para a autorização de carregamento longo renovável.

Pacote com um mestre de 1080p#

Substitua o caminho de origem, Content ID e o caminho de saída abaixo. A pasta de saída deve ser nova ou vazia. O PowerShell usa um backtick no final de uma linha contínua; não adicione espaços após ele.

.\drmx-packager.exe package `
  --profile "Production" `
  --content_id "training-2026-001" `
  --content_title "Training session" `
  --input_source "D:\Sources\training.mp4" `
  --encoding_ladder "sd,hd,full-hd" `
  --video_codec h264 --encoding_preset fast `
  --rate_control smart-quality-vbr --max_frame_rate 24 `
  --audio_bitrate_kbps 128 --segment_duration 6 `
  --packaging_profile maximum-compatibility `
  --key_protection shaka-standard --encrypt_audio `
  --drm_systems "widevine,fairplay,playready,wiseplay" `
  --ffmpeg ".\ffmpeg.exe" --ffprobe ".\ffprobe.exe" `
  --shaka ".\packager-win-x64.exe" `
  --upload-concurrency 8 `
  -o "D:\Protected\training-2026-001"

Isto analisa o código- fonte, codifica a escada seleccionada uma vez, criptografa as saídas configuradas, verifica os manifestos, remove as rendições claras temporárias e envia o pacote protegido. Uma fonte menor do que uma runa pedida não é melhorada. Para UHD, veja 4K, 8K e vídeos longos.

Para manter a saída protegida localmente, adicione --no-upload. Para usar um destino próprio do cliente verificado, adicione --storage_connection_id "YOUR-STORAGE-CONNECTION-ID". Seu padrão configurado é usado quando esta opção é omitida.

Compreender o progresso e a conclusão#

A successful upload reports the verified object count, total bytes, inventory SHA-256 and registered manifest URLs. The last stage includes server verification of object sizes, manifest paths and package KIDs. Keep the Packaging Session ID from the output: it identifies the same package during recovery.

A área de trabalho consome o progresso estruturado CLI. Para a sua própria integração, adicione --progress-format ndjson e analise um JSON objeto por linha; campos opcionais como percent podem ser nulos. Trate um código de saída de processo não nulo como falha ou cancelamento, mesmo se as fases anteriores completarem.

Continuar sem recodificação#

Use upload após terminar a encriptação local, incluindo depois de reiniciar o computador ou após expirar o Token de Acesso ao Pacote original. O seu perfil salvo deverá pertencer ao mesmo Site ID que o pacote concluído. Substitua a sessão de exemplo UUID e a pasta pelos valores do seu log.

.\drmx-packager.exe upload `
  --profile "Production" `
  --session "11111111-2222-4333-8444-555555555555" `
  --input "D:\Protected\training-2026-001" `
  --upload-concurrency 4

Mantenha todo o root de saída, incluindo ambas as pastas de formato de criptografia quando a Compatibilidade Máxima criou duas saídas. Para 1AICLOUD, o CLI compara comprimentos de bytes remotos e SHA-256 metadados, salta objetos correspondentes e continua o trabalho incompleto. Um objeto multiparte incompleto reinicia esse objeto; os objetos já concluídos permanecem reutilizáveis. O armazenamento pré- assinado do cliente pode retransmitir objetos em um currículo manual.

O upload recua após o estrangulamento ou erros temporários de rede e renova temporariamente 1AICLOUD credenciais enquanto mantém o mesmo prefixo de destino e pacote. As partes de grandes objetos falhadas são novamente testadas de forma independente. Comece com objetos paralelos 4–8; a maior concorrência nem sempre é mais rápida. Pare outro processo de envio da mesma pasta antes de retomar.

.\drmx-packager.exe upload `
  --session "11111111-2222-4333-8444-555555555555" `
  --input "D:\Protected\training-2026-001" --dry-run

Esta execução seca lê apenas as contagens e tamanhos de ficheiros locais; não contacta o armazenamento, prova a autorização do servidor ou valida a encriptação. A sessão UUID deve ainda ser sintáticamente válida. Os fluxos de trabalho baseados em sessão legados podem usar um DRMX_PACKAGING_TOKEN válido; a recuperação do perfil salvo é mais simples quando esse token tiver expirado.

Automatizar com ambiente protegido credenciais #

As tarefas não atendidas podem fornecer DRMX_PACKAGER_SITE_ID, DRMX_PACKAGER_ACCESS_KEY e DRMX_PACKAGER_KMS_TOKEN através da sua loja secreta. Opcionalmente, defina DRMX_PACKAGER_SERVER. Omitir --profile neste modo. Não escreva o real credenciais em scripts, controlo de código, argumentos de comandos ou logs.

Execute um comando de pacote por código e atribua um destino único Content ID e vazio de cada vez. Verifique o código de saída antes de continuar. Use upload para um pacote concluído que falhou durante o envio, em vez de repetir automaticamente package. Windows usa os executáveis empacotados mostrados acima. Numa instalação aprovada do Linux CLI, use ./drmx-packager, ./ffmpeg, ./ffprobe e ./packager-linux-x64, com as continuações de linha apropriadas do shell.

Resolução de problemas #