إنشاء عوامل تصفية باستخدام CLI
هل تبحث عن وثائق خدمات الوسائط v2 ؟
هل تواجه مشكلة؟ راجع دليل استكشاف الأخطاء وإصلاحها للحصول على حلول للمشكلات المتعلقة باستخدام خدمات الوسائط.
يمكن العثور على نماذج التعليمات البرمجية في صفحة Samples .
عند تسليم المحتوى إلى العملاء (بث الأحداث المباشرة أو الفيديو عند الطلب)، قد يحتاج العميل إلى مرونة أكثر مما هو موضح في ملف بيان الأصل الافتراضي. تمكنك Azure Media Services من تحديد عوامل تصفية الحساب وعوامل تصفية الأصول للمحتوى الخاص بك.
للحصول على وصف مفصل لهذه الميزة والسيناريوهات التي يتم استخدامها فيها، راجع البيانات الديناميكيةوعوامل التصفية.
يوضح هذا الموضوع كيفية تكوين عامل تصفية لأصل فيديو عند الطلب واستخدام CLI لخدمات الوسائط الإصدار 3 لإنشاء عوامل تصفية الحساباتوعوامل تصفية الأصول.
ملاحظة
تأكد من مراجعة presentationTimeRange.
المتطلبات الأساسية
- أنشئ حساباً لـMedia Services . تأكد من تذكر اسم مجموعة الموارد واسم حساب خدمات الوسائط.
تعريف عامل تصفية
يحدد المثال التالي شروط تحديد المسار التي تتم إضافتها إلى البيان النهائي. يتضمن عامل التصفية هذا أي مسارات صوت EC-3 وأي مسارات فيديو تحتوي على معدل البت في نطاق 0-1000000.
تلميح
إذا كنت تخطط لتعريف عوامل التصفية في REST، فلاحظ أنك بحاجة إلى تضمين كائن JSON الخاص بمضمون "خصائص".
[
{
"trackSelections": [
{
"property": "Type",
"value": "Audio",
"operation": "Equal"
},
{
"property": "FourCC",
"value": "EC-3",
"operation": "NotEqual"
}
]
},
{
"trackSelections": [
{
"property": "Type",
"value": "Video",
"operation": "Equal"
},
{
"property": "Bitrate",
"value": "0-1000000",
"operation": "Equal"
}
]
}
]
إنشاء عوامل تصفية الحساب
ينشئ الأمر التالي az ams account-filter عامل تصفية حساب مع تحديدات تعقب التصفية التي تم تعريفها مسبقا.
يسمح لك الأمر بتمرير معلمة اختيارية --tracks تحتوي على JSON تمثل تحديدات المسار. استخدم @{file} لتحميل JSON من ملف. إذا كنت تستخدم Azure CLI محليا، فحدد مسار الملف بأكمله:
az ams account-filter create -a amsAccount -g resourceGroup -n filterName --tracks @tracks.json
راجع أيضا أمثلة JSON لعوامل التصفية.
إنشاء عوامل تصفية الأصول
ينشئ الأمر التالي az ams asset-filter عامل تصفية أصول مع تحديدات تعقب عامل التصفية التي تم تعريفها مسبقا.
az ams asset-filter create -a amsAccount -g resourceGroup -n filterName --asset-name assetName --tracks @tracks.json
راجع أيضا أمثلة JSON لعوامل التصفية.
إقران عوامل التصفية ب Streaming Locator
يمكنك تحديد قائمة بعوامل تصفية الأصول أو الحسابات، والتي قد تنطبق على "محدد موقع البث". يطبق Dynamic Packager (نقطة نهاية البث) قائمة عوامل التصفية هذه مع تلك التي يحددها العميل في عنوان URL. ينشئ هذا المزيج بيان ديناميكي، والذي يستند إلى عوامل التصفية في URL + عوامل التصفية التي تحددها على Streaming Locator. نوصي باستخدام هذه الميزة إذا كنت تريد تطبيق عوامل التصفية ولكنك لا تريد عرض أسماء عوامل التصفية في عنوان URL.
توضح التعليمات البرمجية CLI التالية كيفية إنشاء Streaming Locator وتحديد filters. هذه خاصية اختيارية تأخذ قائمة مفصولة بمسافة لأسماء عوامل تصفية الأصول و/أو أسماء عوامل تصفية الحساب.
az ams streaming-locator create -a amsAccount -g resourceGroup -n streamingLocatorName \
--asset-name assetName \
--streaming-policy-name policyName \
--filters filterName1 filterName2
الدفق باستخدام عوامل التصفية
بمجرد تحديد عوامل التصفية، يمكن لعملائك استخدامها في عنوان URL المتدفق. يمكن تطبيق عوامل التصفية على بروتوكولات تدفق معدل البت التكيفي: Apple HTTP Live Streaming (HLS) وMPEG-DASH وS smooth Streaming.
يعرض الجدول التالي بعض الأمثلة على عناوين URL مع عوامل التصفية:
| البروتوكول | مثال |
|---|---|
| HLS | https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(format=m3u8-aapl,filter=myAccountFilter) |
| MPEG DASH | https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(format=mpd-time-csf,filter=myAssetFilter) |
| دفق سلس | https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(filter=myAssetFilter) |