التحويلات والوظائف في الخدمات الخاصة بالوسائط

شعار خدمات الوسائط الإصدار 3


تحذير

سيتم إيقاف Azure Media Services في 30 يونيو 2024. لمزيد من المعلومات، راجع دليل إيقاف AMS.

تلميح

هل تريد إنشاء صور مصغرة أو تجميع مقطعي فيديو معا أو وضع علامة فرعية على مقطع فيديو أو تدويره (من بين أشياء أخرى)؟ يمكنك العثور على نموذج التعليمات البرمجية لخدمات الوسائط في صفحة Samples .

يقدم هذا الموضوع تفاصيل حولالتحويلات والوظائف ويشرح العلاقة بين هذه العناصر.

سير العمل التقليدي

التحويل هو مثل وصفة. يساعدك على إنشاء الوصفة مرة واحدة (الخطوة 1)، وإرسال الوظائف باستخدام تلك الوصفة (الخطوة 2).

  1. إنشاء تحويل.
  2. إرسال الوظائف ضمن هذا التحويل.
  3. إدراج التحويلات.
  4. حذف تحويل، في حالة كنت لا تخطط لاستخدامه في المستقبل.

مثال

لنفترض أنك تريد استخراج الإطار الأول من جميع مقاطع الفيديو الخاصة بك كصورة مصغرة - الخطوات التي ستتخذها هي:

  1. حدد الوصفة أو قاعدة معالجة مقاطع الفيديو الخاصة بك: «استخدم الإطار الأول من الفيديو باعتباره صورة مصغرة».
  2. في كل فيديو، ستعلم الخدمة:
    1. مكان إيجاد هذا الفيديو.
    2. المكان الخاص بكتابة صورة الإخراج المصغرة.

ملاحظة

غالبًا ما تكون خصائص Transform وJob من نوع Datetime بتنسيق UTC.

التحويلات

استخدم التحويلات لتهيئة المهام الشائعة لترميز مقاطع الفيديو أو تحليلها. يصف كل تحويل وصفة أو سير عمل من الوظائف لمعالجة ملفات الفيديو أو الصوت. يمكن أن يطبق التحويل الواحد على أكثر من قاعدة واحدة. على سبيل المثال، يمكن أن يحدد التحويل أن كل فيديو يتم ترميزه في ملف MP4 بمعدل بت معين، وأن يتم إنشاء صورة مصغرة من الإطار الأول للفيديو. يمكنك إضافة إدخال TransformOutput واحد لكل قاعدة تريد إدخالها في التحويل الخاص بك. يمكنك استخدام الإعدادات المسبقة لإخبار التحويل عن كيفية معالجة ملفات وسائط الإدخال.

عرض مخطط

في Media Services v3، تكون الإعدادات المسبقة عناصر مكتوبة بقوة في واجهة برمجة التطبيقات نفسها. يمكنك العثور على تعريف "المخطط" لهذه العناصر في Open API Specification (أو Swagger). يمكنك أيضًا عرض التعريفات المحددة مسبقًا (مثل StandardEncoderPreset) في REST API أو ‎.NET SDK أو وثائق مرجعية أخرى لخدمات الوسائط v3 SDK.

إنشاء التحويلات

يمكنك إنشاء التحويلات باستخدام REST أو CLI أو أي من حزم SDK المنشورة. يتم تشغيل واجهة برمجة تطبيقات خدمات الوسائط v3 بواسطة Azure Resource Manager، بحيث يمكنك أيضًا استخدام قوالب Resource Manager لإنشاء التحويلات وتوزيعها في حساب خدمات الوسائط الخاص بك. يمكن استخدام التحكم في الوصول المستند إلى الدور في Azure لتأمين عملية الوصول إلى Transforms.

إنشاء تحويلات

في حالة كنت بحاجة إلى تحديث التحويل الخاص بك، فاستخدم عملية التحديث . وهو مخصص لإجراء التغييرات على الوصف أو أولويات TransformOutputs الأساسية. يجب إكمال التحديثات عند انتهاء جميع المهام قيد التقدم. في حالة كنت تنوي إعادة كتابة الوصفة، فأنت بحاجة إلى إنشاء تحويل جديد.

المهام

"المهمة" هي الطلب الفعلي لخدمات الوسائط لتطبيق"التحويل" الذي أُنشئ على محتوى فيديو أو صوت مدخل معين. بمجرد إنشاء التحويل، يمكنك إرسال المهام عن طريق استخدام واجهات برمجة تطبيقات خدمات الوسائط أو أي من حزم SDK المنشورة. تحدد "Job" معلومات مثل موقع فيديو الإدخال وموقع الإخراج. يمكنك تحديد موقع إدخال الفيديو الخاص بك باستخدام: عناوين HTTPS URLs أو SAS URLs أو Assets.

عملية إدخال الوظيفة من HTTPS

استخدم إدخال مهمة من HTTPS إذا كان المحتوى الخاص بك يمكن الوصول إليه بالفعل عبر عنوان URL ولا تحتاج إلى تخزين الملف المصدر في Azure (على سبيل المثال، الاستيراد من S3). هذا الأسلوب مناسب أيضًا في حالة كان لديك المحتوى في تخزين كائن ثنائي كبير الحجم لـ Azure ولكن ليس لديك حاجة إلى أن يكون الملف في أصل. في الوقت الحالي، يدعم هذا الأسلوب ملفًا واحدًا فقط للإدخال.

HTTPS باعتباره إدخال وظيفة

استخدم أحد الأصول كإدخل مهمة إذا كان محتوى الإدخال موجودا بالفعل في أصل أو تم تخزين المحتوى في ملف محلي. كما أنه خيار جيد في حالة كنت تخطط لنشر أصل الإدخال للبث أو التنزيل (لنفترض أنك تريد نشر mp4 للتنزيل ولكنك تريد أيضًا تحويل الكلام إلى النص أو الكشف عن الوجوه). تدعم هذه الطريقة الأصول متعددة الملفات (على سبيل المثال، مجموعات دفق MBR التي تم تشفيرها محليًا).

فحص تقدم الوظيفة

يمكن الحصول على تقدم وحالة الوظيفة من خلال مراقبة الأحداث باستخدام Event Grid. لمزيد من المعلومات، راجع مراقبة الأحداث باستخدام EventGrid

تحديث الوظائف

يمكن استخدام عملية التحديث على العنصر وظيفة لتعديل الوصف وخصائص الأولوية بعد إرسال الوظيفة. يكون التغيير في خاصية الأولوية فعالا فقط في حالة كانت الوظيفة لا تزال في حالة وضع قائمة الانتظار. في حالة بدأت الوظيفة في المعالجة، أو انتهت، فلن يكون لتغيير الأولوية أي تأثير.

نماذج الترميز

راجع القائمة الشاملة لعينات الترميز للحصول على ترميز.

الحصول على التعليمات والدعم

يمكنك الاتصال بخدمات الوسائط مع الأسئلة أو متابعة تحديثاتنا بإحدى الطرق التالية: