CLI Packager: comandos y recuperación

Abre la CLI incluida#

Descargar y extraer la completa Windows Suite de Package Content. Open PowerShell en la carpeta extraída. Comandos a continuación asumen los binarios FFmpeg suministrados, FFprobe y Shaka están al lado 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"

Cree primero el perfil Production en Desktop Packager, o sustituya el nombre por su perfil guardado. Use CLI 1.0.0-beta.1 con su Suite correspondiente. La recuperación con perfil guardado puede renovar la autorización temporal de subida.

Empaqueta un archivo maestro de 1080p#

Reemplazar la ruta de origen, Content ID y la ruta de salida a continuación. La carpeta de salida debe ser nueva o vacía. PowerShell utiliza un backtick al final de una línea continua; no añadir espacios después de ella.

.\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"

La orden analiza la fuente, codifica una vez los niveles elegidos, cifra las salidas, verifica los manifiestos, elimina las versiones temporales sin cifrar y carga el paquete protegido. Una fuente pequeña no se amplía para alcanzar un nivel superior. Para UHD, consulta 4K, 8K y vídeos largos.

Añada --no-upload para conservar la salida protegida localmente. Añada --storage_connection_id "YOUR-STORAGE-CONNECTION-ID" para un destino propio verificado. Si lo omite, se usa el destino predeterminado configurado.

Comprueba el progreso y la finalización#

Una subida correcta informa de objetos verificados, bytes totales, SHA-256 del inventario y URL de manifiestos registradas. Al final, el servidor verifica tamaños, rutas de manifiesto y KIDs. Conserve Packaging Session ID: identifica el paquete al reanudar.

Desktop consume progreso CLI estructurado. Añada --progress-format ndjson y procese un objeto JSON por línea; campos como percent pueden ser null. Un código de salida distinto de cero indica fallo o cancelación aunque hayan terminado fases anteriores.

Reanuda la carga sin volver a codificar#

Utilice upload después de completar el cifrado local, incluso después de reiniciar el ordenador o después de que el Packaging Access Token original caducó. Su perfil guardado debe pertenecer al mismo Site ID como el paquete completado. Reemplazar la sesión de ejemplo UUID y carpeta con los valores de su registro.

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

Conserve toda la raíz de salida, incluidas ambas carpetas si Maximum Compatibility produjo dos formatos. Para 1AICLOUD, CLI compara tamaño y SHA-256 remotos, omite objetos coincidentes y continúa los pendientes. Un objeto multiparte incompleto reinicia ese objeto; los demás completos se reutilizan. El almacenamiento propio con URL prefirmadas puede retransmitir objetos al reanudar manualmente.

Tras limitación de solicitudes o fallos temporales, el cargador espera y reintenta; renueva credenciales 1AICLOUD manteniendo destino y prefijo. Las partes fallidas de objetos grandes se reintentan por separado. Empiece con 4–8 objetos paralelos; más concurrencia no siempre acelera. Detenga otros procesos sobre la misma carpeta antes de reanudar.

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

Esta simulación solo lee cantidades y tamaños locales. No contacta con almacenamiento ni demuestra autorización o cifrado. El UUID de sesión debe tener formato válido. Los flujos antiguos pueden usar DRMX_PACKAGING_TOKEN válido; con el token caducado es más sencillo recuperar mediante un perfil guardado.

Automatiza con credenciales de entorno protegidas#

Los trabajos desatendidos pueden obtener DRMX_PACKAGER_SITE_ID, DRMX_PACKAGER_ACCESS_KEY y DRMX_PACKAGER_KMS_TOKEN del almacén de secretos y configurar DRMX_PACKAGER_SERVER opcionalmente. Omita --profile en este modo. No escriba credenciales reales en scripts, repositorios, argumentos ni registros.

Ejecute un comando por origen con Content ID único y destino vacío. Compruebe el código de salida antes de continuar. Si solo falló la subida, use upload en vez de repetir package. Windows usa los ejecutables incluidos. En una instalación Linux CLI aprobada, use ./drmx-packager, ./ffmpeg, ./ffprobe y ./packager-linux-x64 con continuaciones de línea del shell.

Solución de problemas#

Probar el resultado publicado y después integrar#

Abra DRM-X Web Player, inicie sesión, elija el mismo entorno y Published Content ID y pulse Play. Compruebe saltos, calidad, sonido e idiomas. Después use la guía de Web SDK y el kit de backend para añadir reproducción al sitio. Separe credenciales de empaquetado y API de reproducción.