DRM-X CLI Packager：命令与故障恢复

打开包含 CLI#

从 包件内容 下载和提取完整的 Windows 套件。 在提取的文件夹中打开 PowerShell 。 下面的命令假设所提供的 FFmpeg、 FFprobe 和 Shaka 二进制是旁边的 drmx-packager.exe 。

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

首先在 Desktop Plamer 中创建 Production 配置文件, 或用您自己保存的配置文件来替换此名称。 使用预览 6 或更新来进行可再生长载授权 。

加密输出包 a 1080p 主机#

替换下面的源路径 Content ID 和输出路径 。 输出文件夹必须是新建或空的 。 PowerShell 在继续行的末尾使用回击; 在它之后不要添加空格 。

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

这将分析源, 编码选中的阶梯一次, 加密已配置的输出, 校验显示, 删除临时清除的递解并上传受保护的加密输出包。 一个比所请求的运行更小的源不升级 。 for UHD,见 4K、8K和长视频.

要将受保护的输出保留在本地, 请附加 --no-upload 。 要使用一个已核实的客户拥有的目的地, 请附加 --storage_connection_id "YOUR-STORAGE-CONNECTION-ID" 。 您所配置的默认值会被省略 。

了解进展和完成情况#

上传成功后会报告已验证的对象数量、总字节数、文件清单的 SHA-256 和已注册的 Manifest URL。最后阶段由服务器验证对象大小、Manifest 路径和加密输出包的 KIDs。请保留输出中的 Packaging Session ID，恢复操作时用它识别同一份加密输出包。

桌面消耗结构化的 CLI 进度 。 对于您的整合, 请添加 --progress-format ndjson 并逐行分析 JSON 对象 ; 如percent 这样的可选字段可能无效 。 将一个非零进程退出代码视为失败或取消, 即使较早的阶段已经完成 。

不重编码而复发#

本地加密完成后可使用 upload，包括电脑重启后或原 Packaging Access Token 过期后。已保存的配置必须与已完成的加密输出包属于同一个 Site ID。请使用日志中的实际值替换示例中的会话 UUID 和文件夹。

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

保留整个输出根, 包括最大兼容性创建两个输出时的两个加密格式文件夹。 对于1AICLOUD , CLI 比较远程字节长度和SHA-256 元数据, 跳过匹配对象并继续不完全的工作。 一个不完整的多段对象重新启动该对象; 已完成的对象仍然可以重新使用。 客户拥有的预先签名的存储器可以在手动恢复时重新发送对象 。

上传器在节奏或临时网络错误后退后, 并更新临时 1AICLOUD 凭据 同时保留相同的目的地和加密输出包前缀 。 失败的大对象部件是独立重试的 。 从 4–8 平行对象开始; 较高的货币不是总能更快的 。 在恢复前停止另一程序上传同一文件夹 。

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

此干运行只读取本地文件计数和大小; 它不会联系存储, 证明服务器授权或验证加密 。 会话 UUID 仍然必须策略上有效 。 遗留会话基于工作流程可以使用有效的DRMX_PACKAGING_TOKEN ; 当该令牌过期时, 保存的预览恢复更为简单 。

与受保护环境自动化 凭据#

无人值守任务可通过安全凭据存储提供 DRMX_PACKAGER_SITE_ID、DRMX_PACKAGER_ACCESS_KEY 和 DRMX_PACKAGER_KMS_TOKEN，并可按需设置 DRMX_PACKAGER_SERVER。此模式下不要传入 --profile。切勿将真实凭据写入脚本、源代码仓库、命令参数或日志。

每个来源运行一个加密输出包命令并指定一个独有的 Content ID 。在继续前检查退出代码。使用 upload 用于在上传过程中失败的完整加密输出包,而不是自动重复 package. Windows 使用上面显示的捆绑的可执行文件。在已核准的 Linux 上 CLI 安装、使用 ./drmx-packager, ./ffmpeg, ./ffprobe 和 ./packager-linux-x64,带有切换贝壳的线条续作.

解决问题#