عوامل التصفية

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


تحذير

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

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

عوامل التصفية هي قواعد من جانب الخادم تتيح لعملائك القيام بأشياء مثل:

  • قم بتشغيل مقطع فيديو فقط (بدلاً من تشغيل الفيديو بالكامل). على سبيل المثال:
    • قم بتقليل البيان لعرض مقطع فرعي لحدث مباشر ("تصفية المقطع الفرعي")، أو
    • اقتطاع بداية الفيديو ("اقتطاع مقطع فيديو").
  • قم فقط بتسليم عمليات الترجمة المحددة و/أو مسارات اللغة المحددة التي يدعمها الجهاز المستخدم لتشغيل المحتوى ("ترشيح التسليم").
  • اضبط نافذة العرض التقديمي DVR لتوفير طول محدود لنافذة DVR في المشغل ("تعديل نافذة العرض").

تمكّنك Media Services من إنشاء عوامل تصفية الحساب وعوامل تصفية الأصول للمحتوى الخاص بك. بالإضافة إلى ذلك، يمكنك إقران عوامل التصفية المنشأة مسبقاً بـ محدد موقع البث.

أنواع عوامل التصفية

هناك نوعان من عوامل التصفية:

  • عوامل تصفية الحساب (عام) - يمكن تطبيقها على أي أصل في حساب Azure Media Services، لها عمر الحساب.
  • عوامل تصفية الأصول (محلي) - يمكن تطبيقها فقط على أحد الأصول التي تم إقران عامل التصفية بها عند الإنشاء، ولها عمر الأصل.

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

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

يمكنك استخدام الخصائص التالية لوصف عوامل التصفية.

الاسم الوصف
firstQuality معدل البت الأول لجودة عامل التصفية.
presentationTimeRange النطاق الزمني للعرض التقديمي لبيان حدث مباشر. تُستخدم هذه الخاصية لتصفية نقاط البداية/النهاية الخاصة بالبيان وطول نافذة العرض وموضع البدء المباشر.
لمزيد من المعلومات، راجع PresentationTimeRange.
Tracks شروط اختيار المسارات. لمزيد من المعلومات، راجع المسارات

presentationTimeRange

استخدم هذه الخاصية مع عوامل تصفية الأصول. لا يوصى بتعيين الخاصية باستخدام عوامل تصفية الحساب.

الاسم الوصف
startTimestamp ينطبق على الفيديو عند الطلب (VoD) أو البث المباشر.
هذه قيمة طويلة تمثل نقطة بداية مطلقة للدفق. يتم تقريب القيمة إلى أقرب بداية GOP تالية. الوحدة هي مقياس الوقت، لذا فإن startTimestamp الذي يبلغ 150000000 سيكون لمدة 15 ثانية.
استخدم startTimestamp وendTimestamp لاقتطاع الأجزاء التي ستكون في قائمة التشغيل (البيان).
على سبيل المثال، ستنشئ startTimestamp = 40000000 وendTimestamp = 100000000 باستخدام مقياس الوقت الافتراضي قائمة تشغيل تحتوي على أجزاء من 4 ثوانٍ إلى 10 ثوانٍ من عرض VoD. إذا امتد جزء ما عبر الحدود، فسيتم تضمين الجزء بأكمله في البيان.
endTimestamp ينطبق على الفيديو عند الطلب (VoD).
بالنسبة إلى عرض البث المباشر، يتم تجاهله وتطبيقه بصمت عندما ينتهي العرض ويصبح البث VoD.
هذه قيمة طويلة تمثل نقطة نهاية مطلقة للعرض التقديمي، مقربة إلى أقرب بداية GOP تالية. الوحدة هي مقياس الوقت، لذا فإن endTimestamp لـ 1800000000 سيكون لمدة 3 دقائق.
استخدم startTimestamp وendTimestamp لاقتطاع الأجزاء التي ستكون في قائمة التشغيل (البيان).
على سبيل المثال، ستنشئ startTimestamp = 40000000 وendTimestamp = 100000000 باستخدام مقياس الوقت الافتراضي قائمة تشغيل تحتوي على أجزاء من 4 ثوانٍ إلى 10 ثوانٍ من عرض VoD. إذا امتد جزء ما عبر الحدود، فسيتم تضمين الجزء بأكمله في البيان.
مقياس الوقت ينطبق على جميع الطوابع الزمنية والمدد في النطاق الزمني للعرض التقديمي، المحدد بعدد الزيادات في ثانية واحدة.
الافتراضي هو 10000000 - عشرة ملايين زيادة في ثانية واحدة، حيث ستكون كل زيادة 100 نانوثانية طويلة. ومع ذلك، قد تختلف القيمة اعتمادا على مصدر الفيديو أو إذا كنت تستخدم حدثا مباشرا مع الترميز في السحابة (افتراضيا إلى 90Khz أو 90000 للفيديو.)
على سبيل المثال، إذا كنت تريد تعيين startTimestamp عند 30 ثانية، يمكنك استخدام قيمة 300000000 عند استخدام مقياس الوقت الافتراضي. تأكد من التحقق من بيان الأصل الخاص بك للتأكد من أن مقياس الوقت لمسار الفيديو موجود في المقياس الذي قمت بتعيينه. عند استخدام الأحداث المباشرة مع الترميز، يمكن أن يكون مقياس الوقت في 90Khz (90000) لمسارات الفيديو و48khz (48000) للمسارات الصوتية.
liveBackoffDuration ينطبق على البث المباشر فقط.
تحدد هذه القيمة أحدث مركز مباشر يمكن للعميل السعي إليه.
باستخدام هذه الخاصية، يمكنك تأخير موضع التشغيل المباشر وإنشاء مخزن مؤقت من جانب الخادم لمشغلين.
الوحدة لهذا العقار هي مقياس زمني (انظر أدناه).
الحد الأقصى لمدة العودة الحية هو 300 ثانية (3000000000).
على سبيل المثال، تعني القيمة 2000000000 أن أحدث محتوى متاح يتأخر 20 ثانية من الحافة الحية الحقيقية.
presentationWindowDuration ينطبق على البث المباشر فقط.
استخدم presentationWindowDuration لتطبيق نافذة منزلقة من الأجزاء لتضمينها في قائمة التشغيل.
الوحدة لهذا العقار هي مقياس زمني (انظر أدناه).
على سبيل المثال، اضبط العرض PresentWindowDuration = 1200000000 لتطبيق نافذة انزلاقية مدتها دقيقتان. سيتم تضمين الوسائط في غضون دقيقتين من الحافة الحية في قائمة التشغيل. إذا امتد جزء إلى الحدود، فسيتم تضمين الجزء بأكمله في قائمة التشغيل. الحد الأدنى لمدة نافذة العرض هو 60 ثانية.
forceEndTimestamp ينطبق على البث المباشر فقط.
يشير إلى ما إذا كانت خاصية endTimestamp يجب أن تكون موجودة. إذا كان هذا صحيحاً، يجب تحديد endTimestamp أو إرجاع تعليمة برمجية طلب غير صالح.
القيم المسموح بها: false، true.

Tracks

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

تصف شروط خاصية مسار التصفية أنواع المسارات، والقيم (الموضحة في الجدول التالي)، والعمليات (متساوية، NotEqual).

الاسم الوصف
معدل البت استخدم معدل البت للمسار للتصفية.

أفضل قيمة هي مجموعة من معدلات البت، بالبت في الثانية. على سبيل المثال، "0-2427000".

ملاحظة: بينما يمكنك استخدام قيمة معدل بت معينة، مثل 250000 (بت في الثانية)، لا يوصى بهذا الأسلوب، حيث يمكن أن تتقلب معدلات البت الدقيقة من أصل إلى آخر.
FourCC استخدم قيمة FourCC للمسار للتصفية.

القيمة هي العنصر الأول في تنسيق برامج الترميز، كما هو محدد في RFC 6381. حالياً، يتم دعم برامج الترميز التالية:
للفيديو: "avc1"، "hev1"، "hvc1"
بالنسبة إلى الصوت: "mp4a"، "ec-3"

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

القيمة هي علامة اللغة التي تريد تضمينها، كما هو محدد في RFC 5646. على سبيل المثال، "en".
الاسم استخدم اسم المسار للتصفية.
النوع استخدم نوع المسار للتصفية.

القيم التالية مسموح بها: "فيديو" أو "صوت" أو "نص".

مثال

يحدد المثال التالي عامل تصفية البث المباشر:

{
  "properties": {
    "presentationTimeRange": {
      "startTimestamp": 0,
      "endTimestamp": 170000000,
      "presentationWindowDuration": 9223372036854776000,
      "liveBackoffDuration": 0,
      "timescale": 10000000,
      "forceEndTimestamp": false
    },
    "firstQuality": {
      "bitrate": 128000
    },
    "tracks": [
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Audio"
          },
          {
            "property": "Language",
            "operation": "NotEqual",
            "value": "en"
          },
          {
            "property": "FourCC",
            "operation": "NotEqual",
            "value": "EC-3"
          }
        ]
      },
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Video"
          },
          {
            "property": "Bitrate",
            "operation": "Equal",
            "value": "3000000-5000000"
          }
        ]
      }
    ]
  }
}

تصفية بيانات HLS أو DASH عند إنشاء محدد موقع البث

تسمح لك Media Services بإنشاء محدد موقع البث الذي تمت تصفيته مسبقا عن طريق تمرير مجموعة من عوامل التصفية في خاصية عامل التصفية على كيان محدد موقع البث. يسمح لك هذا بتصفية جميع البيانات مسبقا على محدد موقع البث. لم يعد البيان الأصلي متوفرا من خلال محدد موقع البث هذا، ولن يتمكن العملاء الذين يطلبون عناوين URL ل DASH أو HLS من محدد موقع البث المصفاة إلا من الوصول إلى الاستجابة التي تمت تصفيتها. هذا مفيد في الحالات التي تريد فيها نشر جزء من أصل فقط، ومنع المستخدمين من الوصول إلى البيان الأصلي الكامل للأصل عن طريق معالجة سلسلة الاستعلام الخاصة بعنوان URL لبيان HLS أو DASH.

يمكنك تحديد قائمة بفلاتر الأصول أو الحساب في محدد مواقع البث. يقوم الرابط الديناميكي بتطبيق قائمة عوامل التصفية هذه مع تلك التي يحددها العميل في عنوان URL. تنشئ هذه المجموعة بياناً ديناميكياً، والذي يعتمد على عوامل التصفية في عنوان URL + عوامل التصفية التي تحددها في محدد موقع البث.

تحديث عوامل التصفية

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

لا يوصى بتحديث تعريف عوامل التصفية المقترنة بمحدد موقع البث المنشور بنشاط، خاصة عند تمكين CDN. يمكن أن تحتوي خوادم البث وشبكات CDN على ذاكرة تخزين مؤقت داخلية قد تؤدي إلى إرجاع البيانات المخزنة مؤقتاً التي لا معنى لها.

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

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

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