CLI Packager: perintah dan pemulihan

Buka termasuk CLI #

Unduh dan ekstrak lengkap Windows Suite dari Paket Konten . Buka PowerShell dalam folder yang diekstrak. Perintah di bawah mengasumsikan FFmpeg yang disediakan, FFprobe dan Shaka binari di samping drmx-packager.exe.

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

Buat profil awal Produksi dalam Desktop Packager , atau ganti nama itu dengan profil tersimpan Anda sendiri. Gunakan previe.6 atau yang lebih baru untuk otorisasi terbarukan panjang-upload.

Paket seorang master 1080p #

Ganti path sumber, Content ID dan path keluaran di bawah. Folder keluaran mesti baru atau kosong. PowerShell memakai suatu backtick di akhir dari baris lanjutan; jangan tambahkan spasi setelah itu.

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

Ini menganalisis sumber, mengkodekan tangga yang dipilih sekali, mengenkripsi keluaran yang dikonfigurasi, memeriksa manifestasi, menghilangkan rensisi sementara jelas dan mengunggah paket yang dilindungi. Sumber yang lebih kecil dari yang diminta rung tidak upscaled. Untuk UHD, lihat 4K, 8K dan video panjang.

Untuk menjaga keluaran terproteksi secara lokal, tambahkan --no-upload. Untuk menggunakan tujuan yang dimiliki oleh pelanggan yang diverifikasi, tambahkan --storage_connection_id "YOUR-STORAGE-CONNECTION-ID". Nilai baku yang dikonfigurasi Anda dipakai ketika opsi ini diabaikan.

Memahami kemajuan dan pelengkapan #

Sebuah laporan upload yang sukses, jumlah objek yang telah diverifikasi, total bytes, inventaris SHA-256 dan URL daftar manifest. Tahap terakhir termasuk server verifikasi ukuran objek, jalur manifes dan paket KIDs. Simpan Packaging Session ID dari keluaran: ini mengidentifikasi paket yang sama selama pemulihan.

Desktop mengonsumsi proses yang terstruktur CLI. Untuk integrasi Anda sendiri, tambahkan --progress-format ndjson dan parse satu objek JSON per baris; ruas opsional seperti percent dapat dibatalkan. Perlakukan kode keluar proses bukan nol sebagai gagal atau pembatalan, bahkan jika tahap sebelumnya selesai.

Lanjutkan tanpa re-encoding #

Use upload after local encryption completed, including after restarting the computer or after the original Packaging Access Token expired. Your saved profile must belong to the same Site ID as the completed package. Replace the example session UUID and folder with the values from your log.

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

Simpan seluruh akar keluaran , termasuk kedua format enkripsi -format folder ketika Kompatibilitas Maksimum dibuat dua keluaran. Untuk 1AICLOUD, CLI membandingkan panjang byte remote dan SHA-256 metadata, melewati objek yang cocok dan terus tidak lengkap. Sebuah objek multipart yang tidak lengkap memulai kembali bahwa objek, telah menyelesaikan tetap dapat digunakan. Penyimpanan presigned dapat mengirimkan kembali objek pada manual.

Uploader mundur setelah throtting atau jaringan sementara galat dan pembaharuan sementara 1AICLOUD kredensial ketika menjaga tujuan dan prefiks paket yang sama. Bagian large- objek yang gagal dicoba secara mandiri. Mulai dengan 4-8 objek paralel; konkuerasi lebih tinggi tidak selalu lebih cepat. Hentikan proses mengunggah folder yang sama sebelum melanjutkan.

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

Uji coba ini membaca berkas lokal dan hanya ukuran; ini tidak menghubungi penyimpanan, membuktikan otorisasi server atau enkripsi validate. Sesi UUID harus masih valid secara sintaktik. Session- legacy berbasis workflow dapat menggunakan valid DRMX_PACKAGING_TOKEN; saved- profile pemulihan lebih sederhana ketika tanda tersebut telah berakhir.

Otomatis dengan lingkungan dilindungi kredensial #

Tugas yang tak diawasi dapat memasok DRMX_PACKAGER_SITE_ID, DRMX_PACKAGER_ACCESS_KEY dan DRMX_PACKAGER_KMS_TOKEN melalui toko rahasia mereka. Secara opsi menata DRMX_PACKAGER_SERVER. Abaikan --profile dalam mode ini. Jangan tulis sebenarnya kredensial ke dalam skrip, kontrol sumber, argumen perintah atau log.

Jalankan satu perintah paket per sumber dan tetapkan unik Content ID dan tujuan kosong setiap waktu. Periksa kode keluar sebelum melanjutkan. Gunakan upload untuk paket yang telah selesai yang gagal selama upload, bukan secara otomatis mengulangi package. Windows memakai tabel eksekusi bundled yang ditampilkan di atas. Pada sebuah Linux yang disetujui CLI instalasi, gunakan ./drmx-packager, ./ffmpeg, ./ffprobe dan ./packager-linux-x64, dengan rangkaian baris shell- sesuai.

Penelusuran masalah#