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