StreamManager
جریانهای درج آگهی پویا را مدیریت می کند. تعاملات با باطن DAI را مدیریت می کند و پینگ های ردیابی و همچنین انتقال جریان و رویدادهای تبلیغاتی را به ناشر انجام می دهد. این مدیر از BaseAdsManager ارث نمی برد زیرا مدیر یک تبلیغ خاص نیست، بلکه مدیر کل جریان است.
سازنده
StreamManager
StreamManager جدید (videoElement، adUiElement، uiSettings)
پارامتر | |
---|---|
عنصر ویدئو | عنصر ویدیوی HTML که در آن پخش انجام می شود. مقدار نباید صفر باشد. |
adUiElement | اختیاری عنصر HTML برای نگهداری عناصر رابط کاربری تبلیغات. این عنصر باید به اندازه ارتفاع و عرض پخش ویدیو باشد و باید مستقیماً روی آن قرار گیرد. اگر ارائه نشود، هیچ رابط کاربری نشان داده نخواهد شد و هیچ تبلیغی که به رابط کاربری نیاز دارد، مانند تبلیغات قابل رد شدن، درخواست نخواهد شد. مقدار نباید صفر باشد. |
uiSettings | اختیاری تنظیمات رابط کاربری برای استفاده برای این جریان. مقدار نباید صفر باشد. |
- پرتاب می کند
زمانی که پارامترهای ورودی الزامات را برآورده نمی کنند.
مواد و روش ها
contentTimeForStreamTime
contentTimeForStreamTime(streamTime) شماره را برمی گرداند
زمان محتوا را بدون تبلیغات برای یک زمان پخش جریانی معین برمی گرداند. زمان پخش جریانی داده شده را برای جاریسازیهای زنده برمیگرداند.
پارامتر | |
---|---|
زمان پخش | عدد زمان پخش با تبلیغات درج شده (در ثانیه). |
- برمی گرداند
پس از حذف تبلیغات، زمان محتوا را که با زمان پخش داده شده مطابقت دارد،
number
.
تمرکز
تمرکز()
در صورت وجود، روی دکمه پرش تمرکز می کند. اگر وجود نداشته باشد، تمرکز بر عناصر تعاملی، از جمله نمادها یا خلاقیت های تعاملی است.
getAdSkippableState
getAdSkippableState() بولی را برمی گرداند
اگر در حال حاضر بتوان تبلیغ را نادیده گرفت، درست است. هنگامی که این مقدار تغییر می کند، StreamManager
یک رویداد StreamEvent.SKIPPABLE_STATE_CHANGED
را اجرا می کند.
- برمی گرداند
boolean
درست است اگر در حال حاضر بتوان تبلیغ را نادیده گرفت، در غیر این صورت نادرست است.
loadStreamMetadata
loadStreamMetadata()
از SDK درخواست می کند تا ابرداده تبلیغات را بارگیری کند و سپس StreamEvent.LOADED را پخش می کند. پس از بازیابی مانیفست جریان از sticher ویدیوی شخص ثالث، این باید به صورت دستی فعال شود. این فقط برای Pod Serving VOD با استیچر ویدیوی شخص ثالث استفاده میشود و برای سایر درخواستهای پخش جریانی غیرفعال است.
onTimedMetadata
onTimedMtadata (فراداده)
در فرهنگ لغت فراداده پردازش شده عبور می کند. فرهنگ لغت از کلید "TXXX" با رشته فوق داده تعریف شده توسط کاربر به عنوان مقدار انتظار دارد. اگر پخش کننده شما فوق داده خام ارائه می کند، به جای آن با StreamManager.processMetadata تماس بگیرید.
پارامتر | |
---|---|
فراداده | هدف - شی فرهنگ لغت فراداده. مقدار نباید صفر باشد. |
قبلی CuePointForStreamTime
previousCuePointForStreamTime(streamTime) CuePoint را برمی گرداند
نقطه نشانه قبلی را برای زمان پخش داده شده برمی گرداند. اگر چنین نقطه نشانه ای وجود نداشته باشد، باطل برمی گردد. این برای پیادهسازی ویژگیهایی مانند snap back استفاده میشود و زمانی فراخوانی میشود که ناشر تشخیص دهد که کاربر برای بازگرداندن کاربر به یک وقفه تبلیغاتی به دنبال آن بوده است.
پارامتر | |
---|---|
زمان پخش | عدد زمان پخشی که به دنبال آن بود. |
- برمی گرداند
nullable CuePoint
نقطه نشانه قبلی را برای زمان پخش داده شده مشخص کنید.
پردازش فراداده
فرآیند متادیتا (نوع، داده، مهر زمانی)
فراداده های زمان بندی شده را برای پخش جریانی زنده پردازش می کند. اگر پخشکننده ویدیوی شما متادیتای تجزیهنشده همراه با مُهرهای زمانی ارائه میدهد، استفاده کنید، در غیر این صورت، با StreamManager.onTimedMetadata تماس بگیرید.
پارامتر | |
---|---|
نوع | رشته برای ابرداده تایپ کنید. برای HLS باید «ID3» یا URI طرح پیام رویداد برای DASH باشد. |
داده ها | (Uint8Array یا رشته غیر تهی) داده های برچسب خام برای ID3، باید کل داده های برچسب خام باشد. برای پیام های رویداد DASH، این رشته داده پیام است. |
مهر زمانی | عدد زمان بر حسب ثانیه که داده ها باید پردازش شوند. برای DASH، این زمان شروع پیام رویداد است. |
جایگزین AdTagParameters
جایگزین AdTagParameters(adTagParameters)
جایگزین تمام پارامترهای برچسب تبلیغاتی مورد استفاده برای درخواستهای تبلیغاتی آتی برای پخش زنده میشود.
پارامتر | |
---|---|
adTagParameters | شی با ویژگی های رشته پارامترهای برچسب آگهی جدید. باید مقادیر رشته ای داشته باشد. مقدار نباید صفر باشد. |
requestStream
requestStream (streamRequest)
درخواست می کند یک جریان با استفاده از پارامترهای جریان ارائه شده بارگیری شود.
پارامتر | |
---|---|
streamRequest | شامل پارامترهایی برای بارگیری فراداده جریان است. مقدار نباید صفر باشد. |
تنظیم مجدد
تنظیم مجدد ()
مدیر جریان را بازنشانی میکند و هرگونه نظرسنجی مداوم را حذف میکند.
setClickElement
setClickElement(clickElement)
عناصر کلیک روی تبلیغات را تنظیم می کند. این عنصر به عنوان گیرنده کلیک یا ضربه زدن در حین پخش آگهی استفاده می شود و ممکن است منجر به ناوبری از صفحه فعلی شود. این اکنون منسوخ شده است و به جای آن باید یک adUiElement به StreamManager منتقل شود. اگر یک adUiElement به سازنده StreamManager داده شود، این روش به یک no-op تبدیل می شود.
پارامتر | |
---|---|
clickElement | عنصر عنصری که به عنوان کلیک روی تبلیغ استفاده می شود. مقدار ممکن است صفر باشد. |
- منسوخ
- به جای آن یک adUiElement برای سازنده StreamManager ارائه دهید.
streamTimeForContentTime
streamTimeForContentTime(contentTime) شماره را برمی گرداند
زمان پخش جریانی را با تبلیغات برای یک زمان محتوای معین برمی گرداند. زمان محتوای داده شده را برای پخش جریانی زنده برمی گرداند.
پارامتر | |
---|---|
contentTime | عدد زمان محتوا بدون تبلیغات (در ثانیه). |
- برمی گرداند
پس از درج تبلیغات، زمان پخش را که با زمان محتوای داده شده مطابقت دارد،
number
.