CLI Packager: comandos e recuperação

Abra a CLI incluída#

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-cli.exe.

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

Crie primeiro o perfil Production em Desktop Packager ou substitua pelo perfil salvo. Use CLI 1.0.0-beta.1 e a Suite correspondente. A retomada por perfil pode renovar a autorização temporária de envio.

Empacote um arquivo 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-cli.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"

O comando analisa a fonte, codifica uma vez os níveis escolhidos, criptografa as saídas, verifica os manifestos, remove as versões temporárias sem criptografia e envia o pacote protegido. Fontes menores não são ampliadas para alcançar um nível solicitado. Para UHD, consulte 4K, 8K e vídeos longos.

Adicione --no-upload para manter a saída protegida local. Adicione --storage_connection_id "YOUR-STORAGE-CONNECTION-ID" para um destino próprio verificado. Se omitido, usa-se o destino padrão configurado.

Verifique o progresso e a conclusão#

Um envio bem-sucedido informa objetos verificados, bytes totais, SHA-256 do inventário e URL de manifestos. Ao final, o servidor verifica tamanhos, caminhos e KIDs. Guarde Packaging Session ID: ele identifica o pacote na recuperação.

Desktop lê progresso CLI estruturado. Adicione --progress-format ndjson e processe um JSON por linha; campos como percent podem ser null. Código de saída diferente de zero indica falha ou cancelamento, mesmo com fases anteriores concluídas.

Retome o upload sem recodificar#

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-cli.exe upload `
  --profile "Production" `
  --session "11111111-2222-4333-8444-555555555555" `
  --input "D:\Protected\training-2026-001" `
  --upload-concurrency 4

Guarde toda a raiz de saída, incluindo as duas pastas se Maximum Compatibility gerar dois formatos. Para 1AICLOUD, CLI compara tamanho e SHA-256 remotos, ignora objetos iguais e continua os pendentes. Um objeto multiparte incompleto reinicia só esse objeto; os demais prontos são reutilizados. Armazenamento próprio pré-assinado pode reenviar ao retomar manualmente.

Após limitação ou falha temporária, o envio espera e tenta novamente, renovando credenciais 1AICLOUD sem mudar destino ou prefixo. Partes de objetos grandes são repetidas separadamente. Comece com 4–8 objetos paralelos; mais nem sempre é melhor. Pare outros envios da mesma pasta antes de retomar.

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

A simulação só lê contagens e tamanhos locais. Não acessa armazenamento nem comprova autorização ou criptografia. O UUID deve ser válido. Fluxos antigos podem usar DRMX_PACKAGING_TOKEN válido; após expiração, a recuperação por perfil salvo é mais simples.

Automatize com credenciais de ambiente protegidas#

Tarefas sem supervisão podem obter DRMX_PACKAGER_SITE_ID, DRMX_PACKAGER_ACCESS_KEY, DRMX_PACKAGER_KMS_TOKEN do cofre de segredos e definir DRMX_PACKAGER_SERVER opcionalmente. Omita --profile nesse modo. Não escreva credenciais reais em scripts, repositório, argumentos ou logs.

Um comando por origem com Content ID único e destino vazio. Confira o código de saída antes de continuar. Se só o envio falhou, use upload em vez de repetir package. Windows usa os executáveis incluídos; Linux CLI aprovado usa ./drmx-packager, ./ffmpeg, ./ffprobe, ./packager-linux-x64 com continuação de linha apropriada ao shell.

Solução de problemas#

Teste o resultado publicado, e depois integre#

Abra DRM-X Web Player, entre, escolha o mesmo ambiente e Published Content ID e pressione Play. Confira saltos, qualidade, som e idiomas. Depois use o guia Web SDK e o kit de backend para adicionar reprodução ao site. Separe credenciais de empacotamento e API de reprodução.