# CLI Packager: lệnh và khôi phục Gói một video chủ, tự động hóa với bảo vệ thông tin xác thực, phiên dịch tiến trình và tiếp tục tải lên bị ngắt quãng mà không cần chỉnh sửa lại. Video đã mã hóa và giấy phép DRM được truyền qua các đường riêng CDN phân phối video đã mã hóa. Backend kiểm tra quyền truy cập, còn dịch vụ giấy phép DRM cho phép giải mã trên thiết bị tương thích. - 01**Lưu trữ / CDN** Phân phối nội dung đã mã hóa đến trình phát. - 02**Backend của bạn** Kiểm tra quyền xem và yêu cầu thông tin cấp quyền phát từ DRM-X. - 03**DRM-X** Xác thực thông tin cấp quyền phát và xử lý yêu cầu giấy phép DRM. - 04**Trình phát + thiết bị** Dùng hệ thống DRM của thiết bị để nhận giấy phép và phát nội dung đã mã hóa. Hậu phương của bạn quyết định truy cập; DRM-X Áp dụng chính sách đã ký. DRM Bằng lái đi theo đường giao hàng riêng. ## Mở cửa bao gồm CLI[#](#open-the-included-cli) Download and extract the complete Windows Suite from [Package Content](https://6.drm-x.com/console/package-content). Open PowerShell in the extracted folder. Commands below assume the supplied FFmpeg, FFprobe and Shaka binaries are beside `drmx-packager.exe`. ``` .\drmx-packager.exe version .\drmx-packager.exe help .\drmx-packager.exe credentials list .\drmx-packager.exe credentials test --profile "Production" ``` Đầu tiên tạo ra **Sản xuất** hồ sơ trong [Trình gói màn hình nền](https://docs.drm-x.com/vi/packaging/desktop)hoặc thay thế tên đó bằng hồ sơ đã lưu riêng. Hãy dùng ô xem thử. 6 hoặc mới hơn để xác thực nạp lại. ## Gói a 1080p Master[#](#package-a-1080p-master) Thay thế đường dẫn nguồn, Content ID và đường dẫn xuất bên dưới. Thư mục xuất cần phải là mới hay rỗng. Trình bao sử dụng độ xoay ngược ở cuối dòng tiếp tục; không thêm khoảng trống sau nó. ``` .\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" ``` Tùy chọn này phân tích nguồn, mã hóa thang đã chọn một lần, mã hóa các kết xuất đã cấu hình, các bản liệt kê, gỡ bỏ phiên bản rõ tạm thời và tải lên gói được bảo vệ. Một nguồn nhỏ hơn một bậc được yêu cầu không được nâng cấp. UHDThấy chưa? [4K, 8K và video dài](https://docs.drm-x.com/vi/packaging/large-videos). Để giữ cho đầu ra được bảo vệ cục bộ, phụ `--no-upload`Để sử dụng một đích được xác nhận cho khách hàng, phụ `--storage_connection_id "YOUR-STORAGE-CONNECTION-ID"`. mặc định đã cấu hình của bạn sẽ được dùng khi tùy chọn này bị bỏ qua. ## Hiểu tiến trình và hoàn thành[#](#understand-progress-and-completion) Phân tích Đọc dấu vết nguồnMật mã Tạo thangMã hóa Bảo vệ mỗi kết xuấtThẩm tra Kiểm tra danh sáchTải lên Chuyển và xuất bản A successful upload reports the verified object count, total bytes, inventory SHA-256 and registered manifest URLs. The last stage includes server verification of object sizes, manifest paths and package KIDs. Keep the Packaging Session ID from the output: it identifies the same package during recovery. Môi trường tiêu thụ cấu trúc đã cấu trúc CLI Cho sự kết hợp của chính bạn, thêm `--progress-format ndjson` và phân tích một JSON đối tượng trên mỗi dòng; trường tùy chọn như `percent` có thể vô giá trị. Xử lý mã thoát không phải là mã thoát của tiến trình là thất bại hoặc hủy bỏ, ngay cả khi giai đoạn trước hoàn thành. ## Tiếp tục lại mà không cần in lại[#](#resume-without-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 ``` **Giữ toàn bộ đầu ra**, bao gồm cả hai thư mục mã hóa khi sự tương thích tối đa C tạo ra hai kết xuất. 1AICLOUDcái CLI So sánh độ dài byte từ xa và SHA-256 Siêu dữ liệu, bỏ qua các đối tượng khớp và tiếp tục làm việc không đầy đủ. Một đối tượng đa phần không đầy đủ khởi động lại đối tượng đó; đã hoàn thành đối tượng vẫn còn có khả năng sử dụng lại. Có thể tự chọn cất giữ các đối tượng đã ký có khả năng chuyển đổi vào tiếp tục bằng tay. Người tải lên trở lại sau khi throtling hoặc lỗi mạng tạm thời và làm lại tạm thời 1AICLOUD thông tin xác thực Trong khi giữ cùng đích và tiền tố gói. Những phần lớn bị lỗi được tái kết nối độc lập. Bắt đầu với 4–8 đối tượng song song; tính năng hợp nhất cao hơn không phải lúc nào cũng nhanh hơn. Dừng lại một tiến trình khác tải lên cùng một thư mục trước khi tiếp tục. ``` .\drmx-packager.exe upload ` --session "11111111-2222-4333-8444-555555555555" ` --input "D:\Protected\training-2026-001" --dry-run ``` Chạy sấy này đọc chỉ tập tin số và kích cỡ cục bộ; nó không liên lạc với kho, chứng minh máy phục vụ cho phép hay xác thực mã hóa. Phiên chạy UUID Hẳn là vẫn hợp lệ theo ngữ pháp. Các luồng công việc dựa trên các phiên chạy có thể sử dụng một hợp lệ `DRMX_PACKAGING_TOKEN`; tiết kiệm thời gian phục hồi đơn giản hơn khi hiệu suất đó đã hết hạn. ## Tự động hoá với môi trường được bảo vệ thông tin xác thực[#](#automate-with-protected-environment-credentials) Công việc không chắc chắn có thể cung cấp `DRMX_PACKAGER_SITE_ID`, `DRMX_PACKAGER_ACCESS_KEY` và `DRMX_PACKAGER_KMS_TOKEN` qua cửa hàng bí mật của họ. `DRMX_PACKAGER_SERVER`. Omit `--profile` trong chế độ này. Đừng ghi thật thông tin xác thực vào tập lệnh, điều khiển nguồn, tham số lệnh hoặc bản ghi. Chạy một lệnh gói trên mỗi nguồn và chỉ định một lệnh duy nhất Content ID và đích rỗng mỗi lần. Hãy kiểm tra mã thoát trước khi tiếp tục. Hãy dùng mã số này. `upload` cho một gói đã hoàn tất thất bại trong khi tải lên, thay vì lặp lại tự động `package`. Windows sử dụng các tập tin thực hiện gói được hiển thị bên trên. Trên một Linux được chấp nhận CLI cài đặt, sử dụng `./drmx-packager`, `./ffmpeg`, `./ffprobe` và `./packager-linux-x64`Với những đường thẳng phù hợp với vỏ đạn tiếp tục. ## Name[#](#troubleshooting) | Thông điệp hay triệu chứng | Hành động tiếp theo | | --- | --- | | Tải lên tạm thời bận hay bị ngắt | Cho phép lùi lại để hoàn tất. Nếu ngân sách thử lại bị cạn kiệt, hãy giữ đầu ra và tiếp tục với sự nhất trí 4 hoặc 2. | | Chứng nhận mã 401 / chứng nhận bị lỗi | Kiểm tra hồ sơ đã lưu, kiểm tra Site ID và xoay/ khoan đã thu hồi thông tin xác thựcMột trình xem DRM License Token không thể cho phép đóng gói. | | Kết xuất phải trống | Dùng một thư mục mới cho bộ mã; dùng việc tải lên để phục hồi một gói đã được bảo vệ xong. | | Việc tải lên khác có thể dùng thư mục được bảo vệ này | Đóng tiến trình tải lên khác. Tập tin khoá bên cạnh có thể còn lại sau khi thoát; chỉ một khoá tập tin đang hoạt động đang phục hồi. | | Chiều dài, checksum hoặc hiển thị xác thực thất bại | Bảo tồn bản ghi và kết xuất. Đừng sửa đổi danh sách hay xuất bản bằng tay. Tiếp tục tiếp tục hỗ trợ phiên chạy ID và lỗi chính tả. | | UHD đã gỡ bỏ bậc hai | Kích thước nguồn quá nhỏ cho nấc thang đó. Dùng một thực tế UHD Nguồn để sản xuất UHD kết xuất. |