StreamManager
وتعالج أحداث عرض الإعلانات الديناميكية. كما يدير هذا النظام التفاعلات مع خلفية DAI ويتعامل مع إشعارات التتبّع، فضلاً عن إعادة توجيه البث وأحداث الإعلانات إلى الناشر. لا يكتسب هذا الحساب الإداري من BaseAdsManager لأنّه ليس مديرًا لإعلان محدّد، ولكنه مدير للبث المباشر بأكمله.
الشركة المصنِّعة
StreamManager
new StreamManager(videoElement, adUiElement, uiSettings)
المَعلمة |
|
|---|---|
|
videoElement |
تمثّل هذه السمة عنصر فيديو HTML الذي سيتم فيه التشغيل. يجب ألا تكون القيمة فارغة. |
|
adUiElement |
إجراء اختياري عنصر HTML المطلوب استخدامه للاحتفاظ بعناصر واجهة مستخدم الإعلان. يجب أن يكون هذا العنصر بالارتفاع والعرض نفسيهما اللذين يتم استخدامهما لتشغيل الفيديو، ويجب أن يظهر فوقه بشكل مباشر. وفي حال عدم توفيرها، لن يتم عرض أي واجهة مستخدم، ولن يتم طلب أي إعلانات تتطلب واجهة مستخدم، مثل الإعلانات القابلة للتخطي. يجب ألا تكون القيمة فارغة. |
|
uiSettings |
إجراء اختياري إعدادات واجهة المستخدم التي سيتم استخدامها في هذا البث يجب ألا تكون القيمة فارغة. |
- عمليات التنفيذ
- EventTarget
- الرميات
-
عندما لا تفي معلَمات الإدخال بالمتطلبات.
الطُرق
contentTimeForStreamTime
يعرض contentTimeForStreamTime(streamTime) رقمًا.
لعرض وقت المحتوى بدون إعلانات لفترة بث محدّدة. تعرض وقت البث المحدّد لأحداث البث المباشر.
المَعلمة |
|
|---|---|
|
streamTime |
الرقم وقت البث مع الإعلانات المدرجة (بالثواني) |
- المرتجعات
-
numberوقت المحتوى الذي يتوافق مع وقت البث المحدّد بعد إزالة الإعلانات
البؤرة
التركيز()
يضع التركيز على زر التخطّي إذا كان متوفّرًا. وفي حال عدم توفّرها، يتم التركيز على العناصر التفاعلية، بما في ذلك الرموز أو المواد الإبداعية التفاعلية.
getAdSkippableState
تعرض getAdSyncpableState() قيمة منطقية.
تعرِض القيمة "صحيح" إذا كان من الممكن تخطّي الإعلان في الوقت الحالي. عند تغيير هذه القيمة،
يطلق StreamManager حدث StreamEvent.SKIPPABLE_STATE_CHANGED.
- المرتجعات
-
booleanصحيح إذا كان يمكن تخطّي الإعلان في الوقت الحالي، أو خطأ في الحالات الأخرى.
loadStreamMetadata
loadStreamMetadata()
يطلب حزمة تطوير البرامج (SDK) تحميل البيانات الوصفية للإعلانات ثم يبث StreamEvent.LOADED. يجب أن يتم تشغيل هذا الإجراء يدويًا بعد استرداد بيان البث من أداة دمج الفيديوهات التابعة لجهة خارجية. يُستخدم هذا الإجراء فقط في الفيديوهات المسجّلة التي تعرض إعلانات عند استخدام أداة دمج فيديوهات تابعة لجهة خارجية، ولا يُسمح به لأي طلبات بث أخرى.
onTimedMetadata
onTimedMetadata(metadata)
البطاقات في قاموس البيانات الوصفية التي تمت معالجتها ويتوقّع القاموس توفُّر المفتاح "TXXX" مع سلسلة البيانات الوصفية التي يحددها المستخدم كقيمة. إذا كان المشغّل يوفّر بيانات وصفية أولية، يمكنك استدعاء StreamManager.processMetadata بدلاً من ذلك.
المَعلمة |
|
|---|---|
|
البيانات الوصفية |
الكائن قاموس بيانات التعريف. يجب ألا تكون القيمة فارغة. |
previousCuePointForStreamTime
preCuePointForStreamTime(streamTime) تعرض CuePoint
لعرض نقطة البداية السابقة لوقت البث المحدّد. تعرض قيمة فارغة في حال عدم توفّر نقطة إشارة واحدة. تُستخدَم هذه الطريقة لتنفيذ ميزات مثل العودة إلى الفيديو، ويتم استدعاءها عندما يكتشف الناشر أنّ المستخدم يسعى لإرجاعه إلى فاصل إعلاني.
المَعلمة |
|
|---|---|
|
streamTime |
الرقم وقت البث المطلوب. |
- المرتجعات
-
nullable CuePointالإشارة السابقة لوقت البث المحدّد.
processMetadata
processMetadata(type, data, timestamp)
معالجة البيانات الوصفية المحدّدة زمنيًا لأحداث البث المباشر استخدِم هذا الخيار إذا كان مشغّل الفيديو يوفّر بيانات وصفية غير موزَّعة مع طوابع زمنية، وفي الحالات الأخرى، اتصل بـ StreamManager.onTimedMetadata.
المَعلمة |
|
|---|---|
|
كتابة |
سلسلة اكتب بيانات التعريف. يجب أن يكون "ID3" لـ HLS أو معرّف الموارد المنتظم (URI) لمخطط رسالة الحدث في DASH. |
|
البيانات |
(Uint8Array أو سلسلة غير فارغة) بيانات العلامة الأولية. بالنسبة إلى المعرّف 3، يجب أن يتضمّن معرّف العلامة الأولية بيانات العلامة الأولية بالكامل. بالنسبة إلى رسائل أحداث DASH، تكون هذه هي سلسلة بيانات الرسالة. |
|
timestamp |
الرقم الوقت بالثواني الذي يجب معالجة البيانات فيه. بالنسبة إلى DASH، هذا هو وقت بدء رسالة الحدث. |
replaceAdTagParameters
replaceAdTagParameters(adTagParameters)
تستبدل كل مَعلمات علامات الإعلان المستخدَمة في طلبات الإعلان القادمة لبث مباشر.
المَعلمة |
|
|---|---|
|
adTagParameters |
عنصر بخصائص السلسلة مَعلمات علامة الإعلان الجديدة. يجب أن يحتوي على قيم سلسلة. يجب ألا تكون القيمة فارغة. |
requestStream
requestStream(streamRequest)
تطلب تحميل بث باستخدام مَعلمات البث المقدَّمة.
المَعلمة |
|
|---|---|
|
streamRequest |
على معلمات لتحميل البيانات الوصفية للبث. يجب ألا تكون القيمة فارغة. |
إعادة ضبط
إعادة الضبط()
يؤدي هذا الإجراء إلى إعادة ضبط مدير البث وإزالة أي استطلاعات مستمرة.
setClickElement
setClickElement(clickElement)
لضبط عنصر النقر على الإعلانات يتم استخدام هذا العنصر كأداة استقبال النقرة أو النقر أثناء عرض إعلان وقد يؤدي إلى الانتقال بعيدًا عن الصفحة الحالية. لقد تم إيقاف هذا الخيار نهائيًا، ويجب تمرير adUiElement إلى StreamManager بدلاً من ذلك. إذا تم منح adUiElement الدالة الإنشائية StreamManager، ستصبح هذه الطريقة بيئة بيئة مستقلة.
المَعلمة |
|
|---|---|
|
clickElement |
عنصر العنصر المستخدم كنقرة على الإعلان. قد تكون القيمة فارغة. |
- منهي العمل به
- يجب إضافة adUiElement إلى الدالة الإنشائية StreamManager بدلاً من ذلك.
streamTimeForContentTime
يعرض streamTimeForContentTime(contentTime) رقمًا.
لعرض وقت البث مع الإعلانات لفترة محتوى معيّنة. تعرض هذه السمة وقت نشر المحتوى في أحداث البث المباشر.
المَعلمة |
|
|---|---|
|
contentTime |
الرقم وقت المحتوى بدون أي إعلانات (بالثواني). |
- المرتجعات
-
numberوقت البث الذي يتوافق مع وقت المحتوى بعد إدراج الإعلانات