# CLI Packager：コマンドと復旧

マスタービデオをパッケージ化し、保護された認証情報と自動化し、進捗を解釈し、再エンコーディングなしで中断されたアップロードを再開します。

暗号化された動画と DRM ライセンスは別の経路で配信されます

CDN は暗号化された動画を配信します。バックエンドが視聴権限を確認し、DRM ライセンスサービスが対応デバイスでの復号を許可します。

- 01**ストレージ / CDN**

暗号化されたメディアをプレーヤーに配信します。

- 02**お客様のバックエンド**

視聴権限を確認し、DRM-X に再生の認可をリクエストします。

- 03**DRM-X**

再生の認可情報を検証し、DRM ライセンスリクエストを処理します。

- 04**プレーヤー + デバイス**

デバイスの DRM システムを使ってライセンスを取得し、暗号化されたメディアを再生します。

バックエンドはアクセスを決定します。DRM-Xは署名されたポリシーを強制します。暗号化されたメディアとDRMのライセンスは、別の配送パスに従います。

## 付属のCLI[#](#open-the-included-cli)を開く

ダウンロードし、完全な抽出 Windows スイートから [パッケージ内容](https://6.drm-x.com/console/package-content). 抽出されたフォルダに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](https://docs.drm-x.com/ja/packaging/desktop) で **Production** プロファイルを作成するか、保存されたプロファイルにその名前を置き換えます。 再生可能な長アップロード許可の Preview.6 または newer を使用してください。



## 1080p master[#](#package-a-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、および長いビデオ](https://docs.drm-x.com/ja/packaging/large-videos)を参照してください。

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



## 進捗状況と完了を把握[#](#understand-progress-and-completion)

アナレイズ
ソーストラックを読みますエンコード
梯子を作成する暗号化
各出力を保護して下さい検証
マニフェストをチェックするアップロード
転送と公開

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

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



## 再符号化せずに再開[#](#resume-without-re-encoding)

ローカル暗号化完了後、コンピュータを再起動した後、または元のパッケージングアクセストークンが期限切れになった後に`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` を使うことができます。 保存されたプロファイルの回復は、トークンが期限切れしたときに簡単です。



## 保護された環境の認証情報[#](#automate-with-protected-environment-credentials)を自動化して下さい

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`, シェル適切なラインの継続で.



## トラブルシューティング[#](#troubleshooting)

| メッセージまたは症状 | 次のアクション | 
| --- | --- |

| 一時的に忙しいか、または中断されたアップロード | バックオフを終了することを可能にします。 再試行の予算が排出されれば、出力を保ち、concurrency 4か2と再開して下さい。 | 

| 401 / 認証検証が失敗しました | 保存したプロファイルをテストし、Site ID をチェックし、 認証情報 を返し/再保存します。ビューア DRM License Token はパッケージを承認できません。 | 

| 出力は空でなければなりません | 新規フォルダを使用してエンコーディング; アップロードを使用して、既に完了した保護されたパッケージを回復します。 | 

| 別のアップロードは、この保護されたフォルダを使用する可能性があります | 他のアップロードプロセスを閉じます。 隣接するロックファイルは、出口の後に残ることができます。 アクティブなファイルロックブロックの回復だけ。 | 

| 長さ、チェックサムまたはマニフェスト検証失敗 | ログと出力を保存します。 手動でマニフェストや公開を編集しないでください。 変更されていないファイルを再開するか、セッションIDと赤字エラーでサポートにお問い合わせください。 | 

| UHD rung 削除 | ソースの寸法は、その rung に小さすぎます。実際の UHD ソースを使用して UHD 出力を生成します。 |

<!-- Canonical: https://docs.drm-x.com/ja/packaging/cli -->
<!-- Language: ja -->