CLI Packager：コマンドと復旧

同梱の CLI を開く#

Package Content から Windows Suite 全体をダウンロードして展開し、そのフォルダーで PowerShell を開きます。以下では FFmpeg、FFprobe、Shaka 実行ファイルが 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"

まず Desktop Packager で Production プロファイルを作成するか、この名前を保存済みのプロファイル名に置き換えます。CLI 1.0.0-beta.1 と対応する Suite を使用してください。保存済みプロファイルでのアップロード再開では、一時的なアップロード許可を更新できます。

1080p の元動画をパッケージ化する#

ソースパス、Content ID、出力パスを置き換えます。出力フォルダーは新規または空にしてください。PowerShell の継続行末にはバックティックを使い、その後に空白を付けません。

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

ソース解析、画質構成のエンコード、暗号化、マニフェスト検証、一時平文の削除、アップロードを行います。ソースより大きい画質には拡大しません。UHD は 4K、8K、長時間動画を参照してください。

保護された出力をローカルに保つには、--no-upload を追加します。 検証済みの顧客所有の宛先を使用するには、--storage_connection_id "YOUR-STORAGE-CONNECTION-ID" を追加します。 このオプションが省略されると、設定されたデフォルトが使用されます。

進捗と完了状態を確認する#

成功すると検証済みオブジェクト数、合計バイト数、一覧の SHA-256、登録済みマニフェスト URL が表示されます。最後にサーバーがサイズ、パス、KIDs を検証します。再開時に同じパッケージを示す Packaging Session ID を保存してください。

Desktop は構造化された CLI 進行情報を使用します。独自統合では --progress-format ndjson を追加し、各行を1つの JSON として解析します。percent などの任意フィールドは null の場合があります。前段階が終わっていても、終了コードがゼロ以外なら失敗またはキャンセルです。

再エンコードせずにアップロードを再開する#

ローカル暗号化完了後は upload を使用できます。再起動後や元の Packaging Access Token 失効後も同様です。保存プロファイルと完了パッケージは同じ Site ID に属する必要があります。セッション UUID とフォルダーはログの値に置き換えます。

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

出力ルート全体を保存してください。Maximum Compatibility が2つの形式を作成した場合は両方のフォルダーが必要です。1AICLOUD では CLI がサイズと SHA-256 を比較し、一致する完成済みオブジェクトを飛ばして残りを続行します。未完了のマルチパートはそのオブジェクトだけやり直します。お客様の事前署名ストレージでは手動再開時に再転送する場合があります。

レート制限や一時的な通信エラー時は待機して再試行し、同じ保存先と接頭辞で 1AICLOUD の一時認証を更新します。失敗した大型オブジェクトの部分は個別に再試行します。並列数は4～8から始めてください。高並列が必ず速いとは限りません。同じフォルダーを送る別プロセスを止めてから再開します。

.\drmx-packager-cli.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 を省略します。実際の認証情報をスクリプト、ソース管理、引数、ログに書かないでください。

ソースごとに1回のパッケージコマンドを実行し、一意の Content ID と空の出力先を指定します。次に進む前に終了コードを確認します。暗号化済みでアップロードだけ失敗した場合は package を繰り返さず upload で再開します。Windows は同梱実行ファイル、承認済み Linux CLI は ./drmx-packager、./ffmpeg、./ffprobe、./packager-linux-x64 と該当シェルの継続行記法を使います。

トラブルシューティング#

公開結果をテストしてから統合する#

DRM-X Web Player を開いてサインインし、同じ環境と Published Content ID を選択して Play を押します。シーク、画質、音声、追加した各言語を確認します。その後、Web SDK ガイドとバックエンド統合キットでサイトに再生を組み込みます。パッケージ化用と再生 API 用の認証情報は別に管理してください。