CLI Packager: Befehle und Wiederaufnahme

Mitgelieferte CLI öffnen#

Laden Sie die komplette Windows Suite aus Paketinhalt 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-cli.exe befinden.

.\drmx-packager-cli.exe version
.\drmx-packager-cli.exe help
.\drmx-packager-cli.exe credentials list
.\drmx-packager-cli.exe credentials test --profile "Production"

Erstellen Sie das Profil Production zuerst in Desktop Packager oder ersetzen Sie den Namen durch Ihr gespeichertes Profil. Verwenden Sie CLI 1.0.0-beta.1 und die passende Suite. Die Fortsetzung mit gespeichertem Profil kann die temporäre Upload-Autorisierung erneuern.

Eine 1080p-Quelldatei paketieren#

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

Der Befehl analysiert die Quelle, encodiert die gewählten Qualitätsstufen einmal, verschlüsselt die Ausgaben, prüft Manifeste, entfernt temporäre unverschlüsselte Varianten und lädt das geschützte Paket hoch. Kleinere Quellen werden nicht auf höhere Stufen hochskaliert. Für UHD siehe 4K, 8K und lange Videos.

Für lokale geschützte Ausgabe fügen Sie --no-upload hinzu. Für geprüftes kundeneigenes Ziel verwenden Sie --storage_connection_id "YOUR-STORAGE-CONNECTION-ID". Ohne Option gilt das konfigurierte Standardziel.

Fortschritt und Abschluss prüfen#

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 liest strukturierte CLI-Fortschritte. Ergänzen Sie --progress-format ndjson und parsen Sie ein JSON-Objekt je Zeile. Optionale Felder wie percent können null sein. Ein Exitcode ungleich null bedeutet Fehler oder Abbruch, auch nach erfolgreichen Teilphasen.

Upload ohne erneutes Encodieren fortsetzen#

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-cli.exe upload `
  --profile "Production" `
  --session "11111111-2222-4333-8444-555555555555" `
  --input "D:\Protected\training-2026-001" `
  --upload-concurrency 4

Behalten Sie den gesamten Ausgabeordner, bei Maximum Compatibility mit zwei Formaten beide Unterordner. Bei 1AICLOUD vergleicht die CLI Größe und SHA-256, überspringt passende vollständige Objekte und setzt andere fort. Ein unvollständiges Multipart-Objekt beginnt erneut; fertige Objekte bleiben verwendbar. Kundeneigener vorsignierter Speicher kann bei manueller Fortsetzung erneut übertragen.

Nach Drosselung oder temporären Netzfehlern wartet der Uploader und versucht erneut. Er erneuert 1AICLOUD-Zugangsdaten bei gleichem Ziel und Präfix. Fehlgeschlagene Teile großer Objekte werden separat wiederholt. Beginnen Sie mit 4–8 parallelen Objekten; mehr ist nicht immer schneller. Stoppen Sie andere Uploads desselben Ordners vor Fortsetzung.

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

Der Testlauf liest nur lokale Anzahl und Größen. Er kontaktiert keinen Speicher und prüft weder Serverautorisierung noch Verschlüsselung. Die Sitzungs-UUID muss gültig sein. Ältere Abläufe können gültiges DRMX_PACKAGING_TOKEN verwenden; nach Ablauf ist das gespeicherte Profil einfacher.

Mit geschützten Umgebungszugangsdaten automatisieren#

Unbeaufsichtigte Aufträge erhalten DRMX_PACKAGER_SITE_ID, DRMX_PACKAGER_ACCESS_KEY, DRMX_PACKAGER_KMS_TOKEN aus dem Geheimnisspeicher und optional DRMX_PACKAGER_SERVER. Lassen Sie --profile dabei weg. Echte Zugangsdaten gehören nicht in Skripte, Quellverwaltung, Argumente oder Protokolle.

Ein Befehl je Quelle mit eindeutiger Content ID und leerem Ziel. Prüfen Sie vor Fortsetzung den Exitcode. Bei reinem Uploadfehler verwenden Sie upload statt package zu wiederholen. Windows nutzt gebündelte Programme, eine genehmigte Linux-CLI-Installation ./drmx-packager, ./ffmpeg, ./ffprobe, ./packager-linux-x64 mit Shell-Zeilenfortsetzung.

Fehlerbehebung#

Testen Sie das veröffentlichte Ergebnis, dann integrieren#

Öffnen Sie DRM-X Web Player, melden Sie sich an, wählen Sie dieselbe Umgebung und Published Content ID und drücken Sie Play. Prüfen Sie Zeitsprünge, Qualität, Ton und Sprachen. Anschließend integrieren Sie mit Web-SDK-Anleitung und Backend-Kit. Trennen Sie Verpackungs- und Wiedergabe-API-Zugangsdaten.