الصف: StreamManager

StreamManager

class   public

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

الشركة المصنِّعة

StreamManager

new StreamManager(mediaElement)

المَعلمة
mediaElement	اختياري عنصر الوسائط في HTML الذي سيتم تشغيل المحتوى فيه لا تقدِّم هذه المعلومات إلا إذا كنت تستخدم مشغّلاً مخصّصًا.

عمليات الرمي

عند عدم تقديم المَعلمات المطلوبة

الموقع

streamMonitor

PodServingStreamMonitor غير صفري

الطُرق

addEventListener

تُعرِض دالة addEventListener(type, listener) قيمة فارغة.

تُضيف أداة معالجة لنوع الحدث المحدّد.

المَعلمة
النوع	سلسلة نوع الحدث الذي سينشط له المشغِل.
أداة معالجة الحدث	function(non-null StreamEvent) دالة يتمّ استدعاؤها في كلّ مرّة يقع فيها حدث من هذا النوع.

المرتجعات

void 

getStreamId

تُعرِض دالة getStreamId() القيمة (null أو سلسلة).

لعرض معرّف البث الحالي.

المرتجعات

(null or string) 

loadStreamMetadata

تُعرِض الدالة loadStreamMetadata() قيمة فارغة.

تطلب حزمة SDK تحميل البيانات الوصفية للإعلان، ثم تبثّ الحدث StreamEvent.LOADED. يجب بدء هذا الإجراء يدويًا بعد استرداد بيان البث من أداة ربط الفيديوهات التابعة لجهة خارجية. لا يتم استخدام هذا الإجراء إلا لعرض الفيديوهات عند الطلب في مجموعة فيديوهات باستخدام أداة لربط الفيديوهات تابعة لجهة خارجية، ولا يتم استخدامه لطلبات البث الأخرى.

المرتجعات

void 

removeEventListener

لا تُعرِض removeEventListener(type, listener) أي قيمة.

تزيل أداة معالجة لنوع الحدث المحدّد. يجب أن تكون دالة المستمع مساوية من حيث المراجع للدالة التي تم تمريرها سابقًا إلى addEventListener.

المَعلمة
النوع	سلسلة نوع الحدث الذي يجب إزالة أداة معالجته
أداة معالجة الحدث	function(non-null StreamEvent) وظيفة الإزالة كمستمع

المرتجعات

void 

replaceAdTagParameters

تُعرِض الدالة replaceAdTagParameters(adTagParameters) قيمة فارغة.

تستبدل هذه السمة جميع مَعلمات علامة الإعلان المستخدَمة لطلبات الإعلانات القادمة لبث مباشر.

المَعلمة
adTagParameters	عنصر يتضمّن سمات سلاسل مَعلمات علامة الإعلان الجديدة يجب أن تحتوي على قيم سلاسل. يجب ألا تكون القيمة فارغة.

المرتجعات

void 

requestStream

requestStream(loadRequest, streamRequest) returns Promise containing (null, non-null cast.framework.messages.LoadRequestData, or non-null cast.framework.messages.ErrorData)

تطلب تحميل بث باستخدام مَعلمات البث المقدَّمة. تعبئة loadRequest ببيانات مصدر البيانات المحمَّل

المَعلمة
loadRequest	cast.framework.messages.LoadRequestData يجب ألا تكون القيمة فارغة.
streamRequest	StreamRequest يجب ألا تكون القيمة فارغة.

المرتجعات

non-null Promise containing (null, non-null cast.framework.messages.LoadRequestData, or non-null cast.framework.messages.ErrorData) 

إعادة ضبط

تُعرِض الدالة reset() قيمة فارغة.

يؤدي هذا الإجراء إلى إعادة ضبط مدير البث وإزالة أي عمليات استطلاع مستمرة.

المرتجعات

void