CLI Packager: lệnh và khôi phục

Mở CLI đi kèm#

Tải và giải nén toàn bộ bộ Windows từ Package Content. Mở PowerShell trong thư mục đã giải nén. Các lệnh dưới đây giả định FFmpeg, FFprobe và Shaka đi kèm nằm cạnh 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"

Tạo hồ sơ Production trong Desktop Packager trước, hoặc thay tên đó bằng hồ sơ đã lưu của bạn. Dùng CLI 1.0.0-beta.1 cùng Suite tương ứng. Khôi phục tải lên bằng hồ sơ đã lưu có thể gia hạn quyền tải lên tạm thời.

Đóng gói tệp nguồn 1080p#

Thay đường dẫn nguồn, Content ID và đường dẫn đầu ra bên dưới. Thư mục đầu ra phải mới hoặc trống. PowerShell dùng dấu backtick ở cuối dòng để nối sang dòng sau; không thêm khoảng trắng sau dấu đó.

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

Lệnh này phân tích nguồn, mã hóa codec các mức chất lượng đã chọn một lần, mã hóa bảo vệ đầu ra đã cấu hình, xác minh manifest, xóa các phiên bản tạm chưa được mã hóa bảo vệ rồi tải gói được bảo vệ lên. Nguồn nhỏ hơn mức yêu cầu sẽ không được nâng độ phân giải. Với UHD, xem 4K, 8K và video dài.

Thêm --no-upload để chỉ giữ đầu ra bảo vệ cục bộ. Thêm --storage_connection_id "YOUR-STORAGE-CONNECTION-ID" để dùng đích riêng đã xác minh. Bỏ qua thì dùng đích mặc định đã cấu hình.

Kiểm tra tiến độ và trạng thái hoàn tất#

Tải lên thành công sẽ báo số đối tượng đã xác minh, tổng byte, SHA-256 danh mục và URL manifest đã đăng ký. Giai đoạn cuối có bước máy chủ xác minh kích thước đối tượng, đường dẫn manifest và KIDs của gói. Giữ Packaging Session ID trong đầu ra để xác định đúng gói khi khôi phục.

Desktop đọc tiến độ CLI có cấu trúc. Thêm --progress-format ndjson, phân tích một JSON mỗi dòng; trường như percent có thể null. Mã thoát khác không là thất bại hoặc hủy, dù giai đoạn trước đã xong.

Tiếp tục tải lên mà không mã hóa video lại#

Dùng upload khi mã hóa bảo vệ cục bộ đã xong, kể cả sau khi khởi động lại máy hoặc Packaging Access Token ban đầu hết hạn. Hồ sơ đã lưu phải thuộc cùng Site ID với gói đã hoàn tất. Thay UUID phiên và thư mục ví dụ bằng giá trị trong nhật ký.

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

Giữ toàn bộ thư mục gốc đầu ra, gồm cả hai thư mục nếu Maximum Compatibility tạo hai định dạng. Với 1AICLOUD, CLI so sánh kích thước và SHA-256, bỏ qua đối tượng khớp và tiếp tục phần còn lại. Đối tượng nhiều phần chưa xong khởi động lại đối tượng đó; đối tượng hoàn tất vẫn tái dùng được. Lưu trữ riêng qua URL ký trước có thể truyền lại khi tiếp tục thủ công.

Khi bị giới hạn hoặc lỗi mạng tạm thời, trình tải chờ rồi thử lại, gia hạn thông tin 1AICLOUD mà giữ đích và tiền tố. Phần lỗi của đối tượng lớn được thử riêng. Bắt đầu với 4–8 đối tượng song song; nhiều hơn không luôn nhanh hơn. Dừng tiến trình khác tải cùng thư mục trước khi tiếp tục.

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

Lần chạy thử chỉ đọc số lượng và kích thước cục bộ. Không kết nối lưu trữ, chứng minh quyền máy chủ hoặc kiểm tra mã hóa bảo vệ. UUID phiên vẫn phải hợp lệ. Luồng cũ có thể dùng DRMX_PACKAGING_TOKEN hợp lệ; khi token hết hạn, hồ sơ đã lưu đơn giản hơn.

Tự động hóa bằng thông tin xác thực môi trường được bảo vệ#

Tác vụ không giám sát có thể lấy DRMX_PACKAGER_SITE_ID, DRMX_PACKAGER_ACCESS_KEY, DRMX_PACKAGER_KMS_TOKEN từ kho bí mật, tùy chọn đặt DRMX_PACKAGER_SERVER. Bỏ --profile ở chế độ này. Không ghi thông tin xác thực thật vào script, mã nguồn, tham số lệnh hoặc nhật ký.

Chạy một lệnh cho mỗi nguồn với Content ID riêng và đích trống. Kiểm tra mã thoát trước khi tiếp tục. Nếu chỉ tải lên thất bại, dùng upload thay vì lặp package. Windows dùng tệp thực thi đi kèm. Linux CLI được duyệt dùng ./drmx-packager, ./ffmpeg, ./ffprobe, ./packager-linux-x64 và cách nối dòng phù hợp shell.

Khắc phục sự cố#

Kiểm tra kết quả Published rồi tích hợp#

Mở DRM-X Web Player, đăng nhập, chọn cùng môi trường và Published Content ID rồi nhấn Play. Xác nhận tua, chất lượng, âm thanh và mọi ngôn ngữ đã thêm. Sau đó dùng hướng dẫn Web SDK và bộ tích hợp backend để thêm phát vào website. Tách thông tin xác thực đóng gói và API phát.