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 Packager で Production プロファイルを作成するか、保存されたプロファイルにその名前を置き換えます。 再生可能な長アップロード許可の Preview.6 または newer を使用してください。

1080p master#をパッケージ化

ソースパス、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"

これは、ソースを分析し、選択した梯子を一度エンコードし、構成された出力を暗号化し、マニフェストを検証し、一時的なクリアな再会を削除し、保護されたパッケージをアップロードします。 要求されたrungよりも小さいソースは、アップスケールされません。 UHDについては、4K、8K、および長いビデオを参照してください。

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

進捗状況と完了を把握#

成功したアップロードは、検証されたオブジェクトのカウント、合計バイト、在庫 SHA-256 および登録されたマニフェスト URL を報告します。最後のステージには、オブジェクトサイズ、マニフェストパス、およびパッケージの KIDs のサーバー検証が含まれます。 出力から [Packaging Session ID] を保持してください: 回復中に同じパッケージを識別します。

デスクトップは構造化された CLI の進捗を消費します。独自の統合のために、--progress-format ndjson を追加し、行ごとに JSON オブジェクトをパースします。percent などのオプションフィールドは null です。以前のフェーズが完了しても、失敗やキャンセルとして、ゼロプロセスの終了コードを処理します。

再符号化せずに再開#

ローカル暗号化完了後、コンピュータを再起動した後、または元のパッケージングアクセストークンが期限切れになった後にuploadを使用します。 保存されたプロファイルは、完了したパッケージと同じSite IDに属している必要があります。 ログから値を持つ例のセッションUUIDとフォルダを置き換えます。

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

は、最大 Compatibility が 2 つの出力を作成するときに、暗号化形式フォルダーを含む、出力された root 全体を比較します。 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 を使うことができます。 保存されたプロファイルの回復は、トークンが期限切れしたときに簡単です。

保護された環境の認証情報#を自動化して下さい

unattended ジョブは、秘密ストアを通じて DRMX_PACKAGER_SITE_ID、DRMX_PACKAGER_ACCESS_KEY および DRMX_PACKAGER_KMS_TOKEN を供給することができます。オプションで DRMX_PACKAGER_SERVER を設定してください。このモードでは --profile を省略します。スクリプト、ソース制御、コマンド引数、ログに 認証情報 を記述しないでください。

ソースごとに1つのパッケージコマンドを実行し、一意に割り当てる Content ID そして、各々の時間に空の宛先を空にします。 続行する前に、出口コードを確認してください。 使用 upload アップロード時に失敗したパッケージの場合、自動的に繰り返します。 package. Windows 上記にバンドルされた実行ファイルを使用します。 承認されたLinux上で CLI 取付け、使用 ./drmx-packager, ./ffmpeg, ./ffprobe そして、 ./packager-linux-x64, シェル適切なラインの継続で.

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