# CLI Packager: Befehle und Wiederaufnahme Verpacken Sie ein Master-Video, automatisieren Sie mit protected Zugangsdaten, interpretieren Sie den Fortschritt und nehmen Sie einen unterbrochenen Upload ohne erneute Kodierung wieder auf. Verschlüsselte Videos und DRM-Lizenzen werden getrennt übertragen Das CDN liefert verschlüsselte Videos. Ihr Backend prüft den Zugriff; der DRM-Lizenzdienst autorisiert die Entschlüsselung auf einem kompatiblen Gerät. - 01**Speicher / CDN** Liefert verschlüsselte Medien an den Player. - 02**Ihr Backend** Prüft die Zugriffsberechtigung des Zuschauers und fordert bei DRM-X die Wiedergabeautorisierung an. - 03**DRM-X** Validiert die Wiedergabeautorisierung und verarbeitet die DRM-Lizenzanfrage. - 04**Player + Gerät** Verwendet das DRM-System des Geräts, um eine Lizenz zu erhalten und die verschlüsselten Medien abzuspielen. Ihr Backend entscheidet über den Zugriff; DRM-X erzwingt die unterschriebene Richtlinie. Verschlüsselte Medien und DRM Lizenzen folgen getrennten Lieferwegen. ## Öffnen Sie die enthaltenen CLI[#](#open-the-included-cli) Laden Sie die komplette Windows Suite aus [Paketinhalt](https://6.drm-x.com/console/package-content) herunter und extrahieren Sie die PowerShell im extrahierten Ordner. Die folgenden Befehle gehen davon aus, dass sich die mitgelieferten Binärdateien FFmpeg, FFprobe und Shaka neben `drmx-packager.exe` befinden. ``` .\drmx-packager.exe version .\drmx-packager.exe help .\drmx-packager.exe credentials list .\drmx-packager.exe credentials test --profile "Production" ``` Erstellen Sie zunächst das **Production**-Profil in [Desktop Packager](https://docs.drm-x.com/de/packaging/desktop) oder ersetzen Sie diesen Namen durch Ihr eigenes gespeichertes Profil. ## Paket einen 1080p Master[#](#package-a-1080p-master) Ersetzen Sie den Quellpfad Content ID und den Ausgabepfad unten. Der Ausgabeordner muss neu oder leer sein. PowerShell verwendet einen Backtick am Ende einer fortgesetzten Zeile; fügen Sie keine Leerzeichen danach hinzu. ``` .\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" ``` Dieser analysiert die Quelle, kodiert die ausgewählte Leiter einmal, verschlüsselt die konfigurierten Ausgänge, überprüft Manifeste, entfernt temporäre klare Wiedergaben und lädt das geschützte Paket hoch. Eine Quelle, die kleiner als eine angeforderte Sprosse ist, wird nicht hochskaliert. Für UHD, siehe [4K, 8K und lange Videos](https://docs.drm-x.com/de/packaging/large-videos). Um die geschützte Ausgabe lokal zu halten, anhängen `--no-upload`. Um ein verifiziertes kundeneigenes Ziel zu verwenden, anhängen `--storage_connection_id "YOUR-STORAGE-CONNECTION-ID"`. Ihre konfigurierte Standardeinstellung wird verwendet, wenn diese Option weggelassen wird. ## Verstehen Fortschritt und Vollendung[#](#understand-progress-and-completion) Analyse Quelltexte lesenCode Erstellen Sie die LeiterVerschlüsselung Schützen Sie jeden OutputPrüfen KontrollmanifesteUpload Übertragung und Veröffentlichung Ein erfolgreicher Upload meldet die Anzahl verifizierter Objekte, Gesamtbytes, Inventar SHA-256 und registrierte Manifest-URLs. Die letzte Stufe beinhaltet die Server-Verifizierung von Objektgrößen, Manifestpfaden und Paket-KIDs. Halten Sie die Packaging Session ID von der Ausgabe ab: Es identifiziert das gleiche Paket während der Wiederherstellung. Desktop verbraucht strukturiert CLI Für Ihre eigene Integration, fügen Sie `--progress-format ndjson` und Parse One JSON Objekt pro Zeile; optionale Felder wie z.B. `percent` Behandeln Sie einen Prozessausgangscode, der nicht null ist, als fehlgeschlagen oder storniert, auch wenn frühere Phasen abgeschlossen wurden. ## Lebenslauf ohne erneute Kodierung[#](#resume-without-re-encoding) Verwenden Sie `upload` nach erfolgter lokaler Verschlüsselung, einschließlich nach dem Neustart des Computers oder nachdem das ursprüngliche Packaging Access Token abgelaufen ist. Ihr gespeichertes Profil muss zur gleichen Site ID wie das fertige Paket gehören. Ersetzen Sie die Beispielsitzung UUID und Ordner mit den Werten aus Ihrem Protokoll. ``` .\drmx-packager.exe upload ` --profile "Production" ` --session "11111111-2222-4333-8444-555555555555" ` --input "D:\Protected\training-2026-001" ` --upload-concurrency 4 ``` **Behalten Sie die gesamte Output-Root**, einschließlich der beiden Verschlüsselungsformatordner, wenn Maximum Compatibility zwei Outputs erstellt hat. Für 1AICLOUD vergleicht der CLI entfernte Bytelängen und SHA-256 Metadaten, überspringt übereinstimmende Objekte und setzt die unvollständige Arbeit fort. Ein unvollständiges mehrteiliges Objekt startet dieses Objekt neu; bereits abgeschlossene Objekte bleiben wiederverwendbar. Kundeneigener vorsignierter Speicher kann Objekte in einem manuellen Lebenslauf erneut übertragen. Der Uploader schaltet sich nach Drosselung oder temporären Netzwerkfehlern zurück und erneuert temporäre 1AICLOUD Zugangsdaten unter Beibehaltung des gleichen Ziel- und Paketpräfixes. Failed large-object parts are retried independent. Beginnen Sie mit 4-8 parallelen Objekten; höhere Parallelität ist nicht immer schneller. Stoppen Sie einen anderen Prozess, der denselben Ordner hochlädt, bevor Sie wieder aufnehmen. ``` .\drmx-packager.exe upload ` --session "11111111-2222-4333-8444-555555555555" ` --input "D:\Protected\training-2026-001" --dry-run ``` Dieser Testlauf liest nur die Anzahl und Größe der lokalen Dateien; er kontaktiert nicht den Speicher, beweist die Autorisierung des Servers oder validiert die Verschlüsselung. Die Sitzung UUID muss immer noch syntaktisch gültig sein. Legacy-Sitzungs-basierte Workflows können eine gültige `DRMX_PACKAGING_TOKEN` verwenden; die Wiederherstellung des gespeicherten Profils ist einfacher, wenn das Token abgelaufen ist. ## Automatisieren mit geschützter Umgebung Zugangsdaten[#](#automate-with-protected-environment-credentials) Unbeaufsichtigte Jobs können `DRMX_PACKAGER_SITE_ID`, `DRMX_PACKAGER_ACCESS_KEY` und `DRMX_PACKAGER_KMS_TOKEN` über ihren geheimen Speicher liefern. Optional `DRMX_PACKAGER_SERVER` einstellen. Auslassen `--profile` in diesem Modus. Schreiben Sie nicht real Zugangsdaten in Skripte, Quellcode, Befehlsargumente oder Protokolle. Führen Sie einen Paketbefehl pro Quelle aus und weisen Sie eine eindeutige Content ID und jedes Mal den Zielort leeren, den Ausstiegscode überprüfen, bevor Sie fortfahren. `upload` für ein abgeschlossenes Paket, das beim Upload fehlgeschlagen ist, anstatt sich automatisch zu wiederholen `package`. Windows verwendet die oben gezeigten gebündelten ausführbaren Dateien. CLI Installation, Verwendung `./drmx-packager`, `./ffmpeg`, `./ffprobe` und `./packager-linux-x64`, mit schalengerechten Linienfortsätzen. ## Fehlersuche[#](#troubleshooting) | Nachricht oder Symptom | Nächste Maßnahme | | --- | --- | | Upload temporär beschäftigt oder unterbrochen | Wenn das retry-budget erschöpft ist, behalten sie die ausgabe bei und setzen sie mit der konkurrenz 4 oder 2 fort. | | 401 / Nachweisvalidierung fehlgeschlagen | Testen Sie das gespeicherte Profil, überprüfen Sie die Site ID und rotieren/wieder speichern widerrufen Zugangsdaten. Ein Zuschauer DRM License Token kann die Verpackung nicht genehmigen. | | Die Produktion muss leer sein | Verwenden Sie einen neuen Ordner für die Kodierung; Verwenden Sie den Upload, um ein bereits abgeschlossenes geschütztes Paket wiederherzustellen. | | Ein anderer Upload kann diesen geschützten Ordner verwenden | Schließen Sie den anderen Upload-Prozess. Die angrenzende Sperrdatei kann nach dem Ausstieg verbleiben; nur eine aktive Sperre blockiert die Wiederherstellung. | | Länge, Prüfsumme oder offensichtliche Überprüfung fehlgeschlagen | Bewahren Sie das Protokoll und die Ausgabe auf. Bearbeiten Sie nicht Manifeste oder veröffentlichen Sie manuell. Setzen Sie unveränderte Dateien fort oder kontaktieren Sie den Support mit der Sitzung ID und korrigieren Sie den Fehler. | | UHD Sprosse entfernt | Die Quellenabmessungen sind zu klein für diese Sprosse. UHD Quelle zur Herstellung UHD Output. |