CLI Packager: 명령 및 복구
마스터 비디오 패키지, 보호 된 인증 정보와 자동화, 해석 진행 및 재 인코딩없이 중단 된 업로드를 다시 시작합니다.
포함 된 열기 CLI#
Package Content에서 완전한 Windows Suite를 다운로드하고 추출합니다. 추출 된 폴더에서 PowerShell을 엽니다. 아래의 명령은 공급된 FFmpeg, FFprobe 및 Shakabinaries는 drmx-packager.exe 옆에 있습니다.
.\drmx-packager.exe version
.\drmx-packager.exe help
.\drmx-packager.exe credentials list
.\drmx-packager.exe credentials test --profile "Production"먼저 Production Desktop Packager에 프로필을 작성하거나 자신의 저장된 프로파일을 가진 이름을 대체합니다. 재생 가능한 롱로드 권한에 대한 미리보기.6 또는 새로운 기능을 사용하십시오.
1080p 마스터 #
아래의 소스 경로, Content ID 및 출력 경로를 대체합니다. 출력 폴더는 새로운 또는 비어 있어야 합니다. PowerShell은 지속적인 라인의 끝에 backtick을 사용합니다. 그 후에 공백을 추가하지 마십시오.
.\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 및 긴 video.
보호 된 출력을 로컬로 유지하기 위해, append --no-upload. 확인 된 고객 소유의 목적지를 사용하려면, append --storage_connection_id "YOUR-STORAGE-CONNECTION-ID". 이 옵션이 잘못되었을 때 구성 된 기본이 사용됩니다.
진행 상황을 파악하고 완료합니다.#
소스 트랙 읽기이름 *
ladder 만들기공유하기
각 산출을 보호하십시오인증 및 인증
자주 묻는 질문제품정보
전송 및 출판
성공적인 업로드는 확인된 객체 수, 총 바이트, 재고 SHA-256 및 등록 된 URL을 보여줍니다. 마지막 단계에는 객체 크기, 표시 경로 및 패키지 KIDs의 서버 검증이 포함되어 있습니다. 출력에서 Packaging Session ID을 유지하십시오. 복구 중에 동일한 패키지를 식별합니다.
데스크톱은 구조화 된 CLI 진행 상황을 사용합니다. 자신의 통합을 위해 --progress-format ndjson을 추가하고 라인 당 하나의 JSON 객체를 파; percent과 같은 옵션 필드는 null이 될 수 있습니다. 실패 또는 취소로 비소 프로세스 종료 코드를 처리하십시오. 이전 단계가 완료되면.
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최대 호환성이 두 개의 출력을 생성 할 때 암호화 형식 폴더를 포함하여 전체 출력 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을 사용할 수 있습니다. 저장된 파일 복구는 토큰이 만료될 때 더 간단합니다.
보호 환경과 자동화 인증 정보#
필수 작업은 비밀 저장소를 통해 DRMX_PACKAGER_SITE_ID, DRMX_PACKAGER_ACCESS_KEY 및 DRMX_PACKAGER_KMS_TOKEN을 공급할 수 있습니다. 선택적으로 DRMX_PACKAGER_SERVER를 설정합니다. 이 모드에서는 --profile를 오스트합니다. 스크립트, 소스 제어, 명령 인수 또는 로그로 실제 인증 정보을 작성하지 마십시오.
소스 당 하나의 패키지 명령을 실행하고 고유 한 Content ID 및 빈 목적지를 할당합니다. 계속하기 전에 출구 코드를 확인하십시오. 업로드 중 실패 한 패키지에 upload를 사용하여 자동 반복 package 대신에 실패했습니다. Windows은 위의 번들 된 실행을 사용합니다. 승인 된 Linux CLI 설치에서 ./drmx-packager, ./ffmpeg, ./ffprobe 및 ./packager-linux-x64을 사용하여 Shell-apeque line continuations.
문제 해결#
| 메시지 또는 symptom | 다음 작업 |
|---|---|
| 일시적으로 바쁘거나 중단된 업로드 | 끝내기 위하여 backoff를 허용하십시오. 재량 예산이 소진되면, 산출을 지키고 concurrency 4 또는 2.로 재개하십시오. |
| 401 / 자격 검증 실패 | 저장된 프로필을 테스트하고 Site ID을 확인하고 회전 / 재 저장 된 인증 정보을 수정합니다. 뷰어 DRM License Token는 포장을 승인 할 수 없습니다. |
| 산출은 빈 이어야 합니다 | 인코딩의 새로운 폴더를 사용; 이미 완성 된 보호 된 패키지를 복구하기 위해 업로드를 사용합니다. |
| 또 다른 업로드는이 보호 된 폴더를 사용할 수 있습니다 | 다른 업로드 프로세스를 닫습니다. 인접한 잠금 파일은 출구 후 남아있을 수 있습니다. 활성 파일 잠금 블록 복구 만. |
| 길이, 체크섬 또는 검증 실패 | 로그 및 출력을 보존합니다. 표시를 편집하거나 수동으로 게시하지 마십시오. 세션 ID 및 redacted 오류로 파일 또는 연락처 지원을 구합니다. |
| UHD rung 제거 | 소스 치수는 rung에 너무 작습니다. 실제 UHD 소스를 사용하여 UHD 출력을 생성합니다. |
DRM-X 6.0