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

فتح CLI المرفق#

نزّل حزمة Windows الكاملة واستخرجها من Package Content. افتح PowerShell داخل المجلد المستخرج. تفترض الأوامر أدناه وجود FFmpeg وFFprobe وShaka المرفقة بجوار drmx-packager-cli.exe.

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

أنشئ ملف Production أولًا في Desktop Packager أو استبدل الاسم بملف إعداداتك المحفوظ. استخدم CLI 1.0.0-beta.1 مع Suite المطابق. يتيح استئناف الرفع عبر الملف المحفوظ تجديد تصريح الرفع المؤقت.

تجهيز ملف مصدر بدقة 1080p#

استبدل مسار المصدر وContent ID ومسار الإخراج أدناه. يجب أن يكون مجلد الإخراج جديدًا أو فارغًا. يستخدم PowerShell علامة backtick في نهاية السطر المتصل بالسطر التالي؛ لا تضف مسافات بعدها.

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

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

أضف --no-upload للاحتفاظ بالإخراج المحمي محليًا، أو --storage_connection_id "YOUR-STORAGE-CONNECTION-ID" لوجهة عميل متحقق منها. عند الإغفال تستخدم الوجهة الافتراضية المضبوطة.

متابعة التقدم والتحقق من اكتمال المهمة#

يعرض الرفع الناجح عدد الكائنات المتحقق منها وإجمالي البايتات وSHA-256 للجرد وعناوين قوائم التشغيل المسجلة. تشمل المرحلة الأخيرة فحص الخادم للأحجام ومسارات قوائم التشغيل وKIDs الحزمة. احتفظ بـ Packaging Session ID من الإخراج لتحديد الحزمة نفسها عند الاستئناف.

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

استئناف الرفع دون إعادة الترميز#

استخدام upload بعد الانتهاء من عملية التشفير المحلية، بما في ذلك بعد إعادة تشغيل الحاسوب أو بعد انتهاء صلاحية التعبئة الأصلية للوصول إلى موقع الوصول، يجب أن يكون ملفك الموفر هو نفس Site ID كما هو الحال بالنسبة للحزمة المكتملة، يستعاض عن الدورة المثالية UUID والمجلد بالقيم من سجلك.

.\drmx-packager-cli.exe upload `
  --profile "Production" `
  --session "11111111-2222-4333-8444-555555555555" `
  --input "D:\Protected\training-2026-001" `
  --upload-concurrency 4

احتفظ بجذر الإخراج كاملًا، بما فيه المجلدان إذا أنشأ Maximum Compatibility تنسيقين. يقارن CLI الأحجام وSHA-256 في 1AICLOUD، ويتجاوز الكائنات المطابقة ويكمل البقية. يعاد بدء الكائن متعدد الأجزاء غير المكتمل فقط؛ المكتمل يعاد استخدامه. قد يعيد تخزين العميل الموقع مسبقًا إرسال الكائنات عند الاستئناف اليدوي.

بعد تحديد المعدل أو خطأ مؤقت ينتظر الرافع ويعيد المحاولة ويجدد بيانات 1AICLOUD مع إبقاء الوجهة والبادئة. تعاد أجزاء الكائن الكبير الفاشلة منفردة. ابدأ بـ 4–8 كائنات متوازية؛ زيادة التوازي ليست أسرع دائمًا. أوقف أي عملية ترفع المجلد نفسه قبل الاستئناف.

.\drmx-packager-cli.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 مع استمرار الأسطر المناسب للصدفة.

استكشاف الأخطاء وإصلاحها#

اختبار النتيجة المنشورة ثم الدمج#

افتح DRM-X Web Player وسجّل الدخول واختر البيئة نفسها وPublished Content ID ثم اضغط Play. تحقق من الانتقال والجودة والصوت وكل لغة مضافة. بعدها استخدم دليل Web SDK وحزمة تكامل خادمك الخلفي لإضافة التشغيل إلى موقعك. افصل بيانات اعتماد التجهيز عن بيانات API التشغيل.