مشاركة عبر

Media Services تتعقب واجهة برمجة التطبيقات

  • مقالة

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

تحذير

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

يحتوي أصل Media Services على ملفات وسائط في حساب تخزين Azure المقترن. تحتوي هذه الملفات على بيانات مسارات الصوت والفيديو والنص. تسمح لك واجهة برمجة تطبيقات المسارات بفهم المسارات الموجودة في الأصل وإدارتها. يتم استخدام المسارات بواسطة مشغل فيديو DASH أو HLS لتقديم الصوت والفيديو والترجمة أو التسميات التوضيحية (النص) للجمهور. تقوم نقطة نهاية دفق Media Services بتوصيل معلومات حول المسارات إلى مشغل عبر بيانات DASH أو قوائم تشغيل HLS عند الطلب.

باستخدام واجهة برمجة تطبيقات المسارات، يمكنك:

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

ملاحظة

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

مسارات النص

استخدام المسارات النصية مع الوسائط المنتجة محليا

بعد إنتاج فيديو محليا وتصدير التسميات التوضيحية، يمكنك تحميل هذه التسميات التوضيحية إلى الأصل الذي يحتوي على الوسائط عند الطلب.

سير العمل العام لاستخدام مسارات النص مع النص المنتج محليا:

  1. إنشاء فيديو وتصدير التسميات التوضيحية إلى ملف بتنسيق VTT أو TTML.
  2. ترجمة ملف VTT أو TTML أو تحريره، وحفظ النسخ من أجل:
    1. مسار للغة إضافية مع نص وصفي لتلبية متطلبات إمكانية وصول ذوي الاحتياجات الخاصة.
    2. مسار لنص إضافي لتعليق المخرج.
  3. هام: يجب إضافة معين اللغة إلى عنوان VTT حتى يتم عرض اللغة الصحيحة في مشغل العميل. على سبيل المثال:
    WEBVTT
Language: en-us
  4. قم بتحميل الفيديو إلى Media Services.
  5. إنشاء تحويل ووظيفة لترميز الفيديو.
  6. قم بتحميل مسارات النص الإضافية.

استخدام مسارات النص مع كتابة الحديث المباشر

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

تحذير

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

سير العمل العام لاستخدام مسارات نص النسخ المباشر:

  1. أنشئ حدثا مباشرا مع تمكين النسخ المباشر ومع تحديد اللغة المصدر.
  2. عند انتهاء الحدث المباشر، انتظر لعدة دقائق، ثم احذف الإخراج المباشر. سيكون الأصل المؤرشف متاحا للبث عند الطلب. سيظل بإمكان المشاهدين الوصول إلى عناوين URL المتدفقة الصالحة.
  3. سرد المسارات في الأصل المؤرشف أو عرضها في المدخل. سيكون هناك ملف WebVTT يحتوي على كتابة NBest. سيكون له ملحق .vtt. تمت تسمية الملف باسم auto-generated-best_XXX.vtt.
  4. قم بتحرير ملف VTT في مدخل Microsoft Azure أو قم بتنزيله وتحريره.
  5. لتقديم مسار النص بلغات متعددة، ترجم مسار النص المصدر إلى تلك اللغات واحفظها كملفات منفصلة لكل لغة باستخدام ملحق .vtt.
  6. قم بتحميل مسار اللغة المصدر، والمسارات النصية لكل لغة.
  7. إذا كنت لا تستخدم مدخل Microsoft Azure لتحميل الملف، فقم بتحرير (أو تحديث) ملف .ism لإخبار المشغل بالمسارات النصية التي يجب استخدامها بالإضافة إلى وضع العلامات والرؤية من خلال:
    1. استخدام واجهة برمجة تطبيقات المسارات لتحديث البيان برمجيا باستخدام إحدى حزم SDK أو CLI:
      1. Node.JS
      2. Python
      3. .صافي
      4. CLI

هام

عند تحديث ملف .ism، تأكد من إخفاء مسار نص النسخ المباشر، وإظهار مسار النص باللغة المناسبة للعارض.

مسارات الصوت

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

سير العمل العام للمسارات الصوتية

  1. إنشاء مسارات صوت إضافية للحدث المباشر. يمكن أن تكون صوتية بلغات مختلفة أو صوت وصفي يستخدم لإمكانية الوصول. يمكنك أيضا استخدام مسار صوتي لتعليق المخرج.
  2. قم بتحميل المسارات الصوتية إلى الأصل المؤرشف.
  3. قم بتحديث بيانات المسار عن طريق تحرير ملف البيان في المدخل أو عن طريق تحديث بيانات المسار باستخدام REST أو SDK.

ملاحظة

عند إزالة مسار صوت أو نص، لا تتم إزالة الملف الأساسي من حاوية التخزين. تعين Media Services المحزم الديناميكي (نقطة نهاية البث) لعدم إظهار المعلومات حول المسار في البيان أو قائمة التشغيل التي يطلبها مشغل الفيديو.

للحصول على خطوات مفصلة لواجهة برمجة تطبيقات المسارات، راجع العينات أدناه.

عينات

الكيفية والبرامج التعليمية وقوالب التشغيل السريع

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

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