أداة CLI Packager: الأوامر والاستعادة

أفتحي الباب CLI#

Download and extract the complete Windows Suite from 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"

First create the Production profile in Desktop Packager, or replace that name with your own Save profile. Use preview.6 or newer for renewable long-upload authorization.

مجموعة من 1080 درجة#

يستعاض عن مسار المصدر Content ID وطريق الإنتاج أدناه، ويجب أن يكون ملف النواتج جديداً أو فارغاً، وتستخدم شركة باورشيل مقياساً احتياطياً في نهاية خط مستمر، ولا تضيف حيزاً بعده.

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

تحلل هذه العملية المصدر، وترمّز مستويات الجودة المختارة مرة واحدة، وتشفّر المخرجات المحددة، وتتحقق من ملفات البيان، وتحذف النسخ المؤقتة غير المشفرة، ثم ترفع الحزمة المحمية. لا تُرفع دقة المصدر إذا كانت أقل من المستوى المطلوب. لمحتوى UHD، راجع فيديوهات 4K و8K والفيديوهات الطويلة.

للحفاظ على الناتج المحمي محليا، التذييل --no-upload- استخدام وجهة مؤكدة مملوكة للزبائن، --storage_connection_id "YOUR-STORAGE-CONNECTION-ID"الفشل المُحدّد الخاص بك يُستخدم عندما يُحذف هذا الخيار.

فهم التقدم المحرز والانتهاء#

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.

ويستهلك مكتب خدمات الرقابة التقدم المهيكل CLI، ويضاف إلى التكامل الخاص --progress-format ndjson والنص الأول JSON ' الهدف لكل خط؛ ويمكن أن تكون الميادين الاختيارية مثل percent باطلة، ويعالج رمز الخروج غير الصفري كفشل أو إلغاء، حتى وإن اكتملت المراحل السابقة.

الاستهلاك دون إعادة الترميز#

استخدام 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

احتفظ بجذور الناتج بكاملها ، بما في ذلك المطوّرات الشفرية عند بلوغ الحد الأقصى للقابلية للمقارنة ناتجين، وبالنسبة لـ 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 صالحة؛ والاسترداد الموفر أبسط عندما تنتهي فترة الانهيار.

Automate with protected environment بيانات الاعتماد#

الوظائف غير المأهولة يمكن أن توفر DRMX_PACKAGER_SITE_ID, DRMX_PACKAGER_ACCESS_KEY و DRMX_PACKAGER_KMS_TOKEN من خلال متجرهم السري DRMX_PACKAGER_SERVERأولاً - --profile في هذه الحالة، لا تكتبي بشكل حقيقي بيانات الاعتماد في النصوص، مراقبة المصدر، حجج القيادة أو السجلات.

تشغيل مجموعة واحدة من الأوامر لكل مصدر، وتعيين فريدة Content ID و الوجهة الفارغة في كل مرة تحقق من رمز الخروج قبل الاستمرار upload من أجل حزمة مكتملة أخفقت أثناء تحميلها، بدلاً من تكرارها تلقائياً package. Windows تستخدم المنفذات المجمّعة المبيّنة أعلاه. CLI التركيب والاستخدام ./drmx-packager, ./ffmpeg, ./ffprobe و ./packager-linux-x64مع استمرار خط الطلقات

Troubleshooting#