عوامل التصفية
هل تبحث عن وثائق خدمات الوسائط v2 ؟
هل تواجه مشكلة؟ راجع دليل استكشاف الأخطاء وإصلاحها للحصول على حلول للمشكلات المتعلقة باستخدام خدمات الوسائط.
يمكن العثور على نماذج التعليمات البرمجية في صفحة العينات .
عند تسليم المحتوى إلى العملاء (أحداث البث المباشر أو الفيديو عند الطلب) قد يحتاج العميل إلى مرونة أكثر مما هو موضح في ملف بيان الأصل الافتراضي. تقدم Azure Media Services بيانات ديناميكية استنادا إلى عوامل تصفية محددة مسبقا.
عوامل التصفية هي قواعد من جانب الخادم تسمح لعملائك بالقيام بأشياء مثل:
- قم بتشغيل مقطع من مقطع فيديو فقط (بدلا من تشغيل الفيديو بأكمله). على سبيل المثال:
- قم بتقليل البيان لإظهار مقطع فرعي لحدث مباشر ("تصفية القصاصة الفرعية")، أو
- اقتطاع بداية مقطع فيديو ("اقتطاع مقطع فيديو").
- قم بتسليم التسليمات المحددة و/أو مسارات اللغة المحددة التي يدعمها الجهاز المستخدم لتشغيل المحتوى مرة أخرى ("تصفية التسليم").
- اضبط نافذة العرض التقديمي (DVR) لتوفير طول محدود لنافذة DVR في المشغل ("ضبط نافذة العرض التقديمي").
تمكنك خدمات الوسائط من إنشاء عوامل تصفية الحسابوعوامل تصفية الأصول للمحتوى الخاص بك. بالإضافة إلى ذلك، يمكنك إقران عوامل التصفية التي تم إنشاؤها مسبقا ب Streaming Locator.
أنواع التصفية
هناك نوعان من عوامل التصفية:
- عوامل تصفية الحساب (العمومية) - يمكن تطبيقها على أي أصل في حساب Azure Media Services، لها مدة بقاء للحساب.
- عوامل تصفية الأصول (محلية) - لا يمكن تطبيقها إلا على أصل كان عامل التصفية مرتبطا به عند الإنشاء، ويكون لها عمر الأصل.
تحتوي أنواع عوامل تصفية الحساباتوعوامل تصفية الأصول على نفس الخصائص بالضبط لتعريف/وصف عامل التصفية. باستثناء عند إنشاء عامل تصفية الأصول، تحتاج إلى تحديد اسم الأصل الذي تريد إقران عامل التصفية به.
استنادا إلى السيناريو الخاص بك، يمكنك تحديد نوع عامل التصفية الأكثر ملاءمة (عامل تصفية الأصول أو عامل تصفية الحساب). تعد عوامل تصفية الحساب مناسبة لملفات تعريف الأجهزة (تصفية التسليم) حيث يمكن استخدام عوامل تصفية الأصول لاقتطاع أصل معين.
يمكنك استخدام الخصائص التالية لوصف عوامل التصفية.
| الاسم | الوصف |
|---|---|
| firstQuality | معدل البت الأول للجودة لعامل التصفية. |
| ترتيب وقت العرض التقديمي | النطاق الزمني للعرض التقديمي. يتم استخدام هذه الخاصية لتصفية نقاط بدء/نهاية البيان وطول نافذة العرض التقديمي وموضع البدء المباشر. لمزيد من المعلومات، راجع PresentationTimeRange. |
| المسارات | يتعقب شروط التحديد. لمزيد من المعلومات، راجع المسارات |
ترتيب وقت العرض التقديمي
استخدم هذه الخاصية مع عوامل تصفية الأصول. لا ينصح بتعيين الخاصية باستخدام عوامل تصفية الحساب.
| الاسم | الوصف |
|---|---|
| طابع وقت الانتهاء | ينطبق على الفيديو عند الطلب (VoD). بالنسبة إلى العرض التقديمي للبث المباشر، يتم تجاهله وتطبيقه بصمت عند انتهاء العرض التقديمي ويصبح الدفق VoD. هذه قيمة طويلة تمثل نقطة نهاية مطلقة للعرض التقديمي، مقربة إلى أقرب بدء GOP التالي. الوحدة هي مقياس الوقت، لذلك سيكون طابع وقت الانتهاء 1800000000 لمدة 3 دقائق. استخدم startTimestamp وendTimestamp لاقتطاع الأجزاء التي ستكون في قائمة التشغيل (البيان). على سبيل المثال، startTimestamp=40000000 وendTimestamp=100000000 باستخدام مقياس الوقت الافتراضي سينشئ قائمة تشغيل تحتوي على أجزاء من بين 4 ثوان و10 ثوان من عرض VoD التقديمي. إذا كان جزء ما يجتاز الحدود، فسيتم تضمين الجزء بأكمله في البيان. |
| forceEndTimestamp | ينطبق على البث المباشر فقط. يشير إلى ما إذا كان يجب أن تكون خاصية endTimestamp موجودة. إذا كان صحيحا، يجب تحديد endTimestamp أو إرجاع رمز طلب غير صحيح. القيم المسموح بها: خطأ، صحيح. |
| liveBackoffDuration | ينطبق على البث المباشر فقط. تحدد هذه القيمة أحدث موضع مباشر يمكن للعميل السعي إليه. باستخدام هذه الخاصية، يمكنك تأخير موضع التشغيل المباشر وإنشاء مخزن مؤقت من جانب الخادم للاعبين. وحدة هذه الخاصية هي مقياس الوقت (انظر أدناه). الحد الأقصى لمدة التراجع المباشر هو 300 ثانية (3000000000). على سبيل المثال، تعني قيمة 2000000000 أن أحدث محتوى متوفر هو 20 ثانية مؤجلة من الحافة المباشرة الحقيقية. |
| عرض تقديميWindowDuration | ينطبق على البث المباشر فقط. استخدم presentationWindowDuration لتطبيق نافذة منزلقة من الأجزاء لتضمينها في قائمة تشغيل. وحدة هذه الخاصية هي مقياس الوقت (انظر أدناه). على سبيل المثال، قم بتعيين presentationWindowDuration=1200000000 لتطبيق نافذة منزلقة لمدة دقيقتين. سيتم تضمين الوسائط في غضون دقيقتين من الحافة المباشرة في قائمة التشغيل. إذا كان جزء ما يجتاز الحدود، فسيتم تضمين الجزء بأكمله في قائمة التشغيل. الحد الأدنى لمدة نافذة العرض التقديمي هو 60 ثانية. |
| طابع وقت البدء | ينطبق على الفيديو عند الطلب (VoD) أو البث المباشر. هذه قيمة طويلة تمثل نقطة بداية مطلقة للتدفق. يتم تقريب القيمة إلى أقرب بدء GOP التالي. الوحدة هي مقياس الوقت، لذلك سيكون طابع البدء 150000000 لمدة 15 ثانية. استخدم startTimestamp وendTimestampp لاقتطاع الأجزاء التي ستكون في قائمة التشغيل (البيان). على سبيل المثال، startTimestamp=40000000 وendTimestamp=100000000 باستخدام مقياس الوقت الافتراضي سينشئ قائمة تشغيل تحتوي على أجزاء من بين 4 ثوان و10 ثوان من عرض VoD التقديمي. إذا كان جزء ما يجتاز الحدود، فسيتم تضمين الجزء بأكمله في البيان. |
| المقياس الزمني | ينطبق على جميع الطوابع الزمنية والمدد في النطاق الزمني للعرض التقديمي، المحدد على أنه عدد الزيادات في ثانية واحدة. الافتراضي هو 10000000 - عشرة ملايين زيادة في ثانية واحدة، حيث سيكون طول كل زيادة 100 نانو ثانية. على سبيل المثال، إذا كنت تريد تعيين startTimestamp في 30 ثانية، يمكنك استخدام قيمة 300000000 عند استخدام مقياس الوقت الافتراضي. |
المسارات
يمكنك تحديد قائمة بشروط خاصية تعقب عامل التصفية (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"
}
]
}
]
}
}
ربط عوامل التصفية بمحدد موقع البث
يمكنك تحديد قائمة بعوامل تصفية الأصول أو الحسابات على "محدد موقع البث". يطبق Dynamic Packager قائمة عوامل التصفية هذه مع تلك التي يحددها العميل في عنوان URL. تنشئ هذه المجموعة بيان ديناميكي، والذي يستند إلى عوامل التصفية في URL + عوامل التصفية التي تحددها على Streaming Locator.
تحديث عوامل التصفية
لا يمكن تحديث "محددات مواقع البث" بينما يمكن تحديث عوامل التصفية.
لا يوصى بتحديث تعريف عوامل التصفية المقترنة بمحدد موقع دفق منشور بنشاط، خاصة عند تمكين CDN. يمكن أن تحتوي خوادم البث و CDNs على ذاكرة تخزين مؤقت داخلية قد تؤدي إلى إرجاع بيانات قديمة مخزنة مؤقتا.
إذا كان تعريف عامل التصفية بحاجة إلى تغيير، ففكر في إنشاء عامل تصفية جديد وإضافته إلى عنوان URL لمحدد موقع البث أو نشر محدد موقع تدفق جديد يشير إلى عامل التصفية مباشرة.