CLI Packager: perintah dan pemulihan

Buka CLI yang disertakan#

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

Buat profil Production dahulu di Desktop Packager, atau ganti nama dengan profil tersimpan. Gunakan CLI 1.0.0-beta.1 dengan Suite yang sesuai. Pemulihan melalui profil dapat memperbarui izin unggah sementara.

Kemas file 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-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"

Perintah ini menganalisis sumber, mengodekan tingkat kualitas pilihan sekali, mengenkripsi keluaran, memverifikasi manifest, menghapus versi sementara tanpa enkripsi, lalu mengunggah paket terlindungi. Sumber kecil tidak diperbesar untuk memenuhi tingkat yang diminta. Untuk UHD, lihat 4K, 8K dan video panjang.

Tambahkan --no-upload untuk menyimpan keluaran lokal terlindungi. Tambahkan --storage_connection_id "YOUR-STORAGE-CONNECTION-ID" untuk tujuan milik pelanggan yang terverifikasi. Tanpa opsi, tujuan baku yang dikonfigurasi digunakan.

Periksa progres dan status selesai#

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 membaca kemajuan CLI terstruktur. Tambahkan --progress-format ndjson dan baca satu JSON per baris; kolom seperti percent dapat null. Kode keluar bukan nol berarti gagal atau dibatalkan walau tahap sebelumnya selesai.

Lanjutkan unggahan tanpa pengodean ulang#

Gunakan upload setelah enkripsi lokal selesai, termasuk setelah komputer dimulai ulang atau Packaging Access Token awal kedaluwarsa. Profil dan paket harus berasal dari Site ID yang sama. Ganti UUID sesi dan folder contoh dengan nilai log.

.\drmx-packager-cli.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 folder bila Maximum Compatibility membuat dua format. Untuk 1AICLOUD, CLI membandingkan ukuran dan SHA-256, melewati objek cocok lalu melanjutkan sisanya. Objek multipart belum selesai mengulang objek itu; objek lain yang lengkap tetap dapat digunakan. Penyimpanan presigned milik pelanggan dapat mengirim ulang saat dilanjutkan manual.

Saat pembatasan atau gangguan sementara, pengunggah menunggu lalu mencoba lagi, memperbarui kredensial 1AICLOUD dengan tujuan dan awalan sama. Bagian objek besar yang gagal dicoba terpisah. Mulai dengan 4–8 objek paralel; lebih banyak tidak selalu lebih cepat. Hentikan unggahan lain pada folder sama sebelum melanjutkan.

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

Simulasi hanya membaca jumlah dan ukuran lokal. Tidak menghubungi penyimpanan, membuktikan otorisasi server, atau memvalidasi enkripsi. UUID sesi harus valid. Alur lama dapat memakai DRMX_PACKAGING_TOKEN valid; bila token kedaluwarsa, pemulihan profil lebih mudah.

Otomatiskan dengan kredensial lingkungan yang terlindungi#

Tugas tanpa pengawasan dapat mengambil DRMX_PACKAGER_SITE_ID, DRMX_PACKAGER_ACCESS_KEY, DRMX_PACKAGER_KMS_TOKEN dari penyimpanan rahasia serta mengatur DRMX_PACKAGER_SERVER bila perlu. Hilangkan --profile dalam mode ini. Jangan menulis kredensial nyata pada skrip, repositori, argumen, atau log.

Jalankan satu perintah per sumber dengan Content ID unik dan tujuan kosong. Periksa kode keluar sebelum lanjut. Jika hanya unggahan gagal, gunakan upload, bukan mengulang package. Windows memakai program bawaan. Linux CLI yang disetujui memakai ./drmx-packager, ./ffmpeg, ./ffprobe, ./packager-linux-x64 dengan kelanjutan baris shell yang sesuai.

Pemecahan masalah#

Uji hasil yang diterbitkan, kemudian integrasi#

Buka DRM-X Web Player, masuk, pilih lingkungan yang sama serta Published Content ID, lalu Play. Periksa perpindahan waktu, kualitas, suara, dan bahasa. Setelah itu, gunakan panduan Web SDK dan kit backend untuk menambah pemutaran ke situs. Pisahkan kredensial pengemasan dan API pemutaran.