StreamManager
यह डाइनैमिक विज्ञापन इंसर्शन की स्ट्रीम मैनेज करता है. यह डीएआई बैकएंड के साथ इंटरैक्शन को मैनेज करता है. साथ ही, यह ट्रैकिंग पिंग मैनेज करता है. साथ ही, पब्लिशर को स्ट्रीम और विज्ञापन इवेंट को फ़ॉरवर्ड करता है. यह मैनेजर, BaseAdsManager से इनहेरिट नहीं करता है. ऐसा इसलिए है, क्योंकि यह किसी खास विज्ञापन का मैनेजर नहीं है, बल्कि पूरी स्ट्रीम का मैनेजर है
निर्माता
StreamManager
नया StreamManager(videoElement, adUiElement, uiSettings)
पैरामीटर |
|
|---|---|
|
videoElement |
वह एचटीएमएल वीडियो एलिमेंट जहां वीडियो चलाया जाएगा. मान शून्य नहीं होना चाहिए. |
|
adUiElement |
ज़रूरी नहीं है विज्ञापन यूज़र इंटरफ़ेस (यूआई) एलिमेंट को होल्ड करने के लिए इस्तेमाल किया जाने वाला एचटीएमएल एलिमेंट. इस एलिमेंट की ऊंचाई और चौड़ाई, वीडियो चलाने वाले एलिमेंट के बराबर होनी चाहिए. साथ ही, इस एलिमेंट की लंबाई और चौड़ाई, उस पर सीधे तौर पर होनी चाहिए. अगर यह विकल्प नहीं दिया गया है, तो यूज़र इंटरफ़ेस (यूआई) नहीं दिखाया जाएगा. साथ ही, ऐसे किसी भी विज्ञापन का अनुरोध नहीं किया जाएगा जिसके लिए यूज़र इंटरफ़ेस (यूआई) की ज़रूरत होती है. जैसे, स्किप किए जा सकने वाले विज्ञापन. मान शून्य नहीं होना चाहिए. |
|
uiSettings |
ज़रूरी नहीं है इस स्ट्रीम के लिए इस्तेमाल की जाने वाली यूज़र इंटरफ़ेस (यूआई) सेटिंग. मान शून्य नहीं होना चाहिए. |
- थ्रो
-
जब इनपुट पैरामीटर ज़रूरी शर्तों को पूरा न करते हों.
तरीके
contentTimeForStreamTime
contentTimeForStreamTime(streamTime) नंबर दिखाता है
किसी दिए गए स्ट्रीम समय के लिए विज्ञापनों के बिना कॉन्टेंट का समय देता है. लाइव स्ट्रीम के लिए, स्ट्रीम में लगने वाले समय की जानकारी देता है.
पैरामीटर |
|
|---|---|
|
streamTime |
नंबर डाले गए विज्ञापनों के साथ स्ट्रीम का समय (सेकंड में). |
- सामान लौटाना
-
numberविज्ञापन हटाने के बाद, स्ट्रीम में बिताए गए समय के हिसाब से कॉन्टेंट का समय.
focus
फ़ोकस()
अगर मौजूद हो, तो 'स्किप करें' बटन पर फ़ोकस करता है. अगर यह जानकारी मौजूद नहीं है, तो फ़ोकस को आइकॉन या इंटरैक्टिव क्रिएटिव जैसे इंटरैक्टिव एलिमेंट पर दिया जाता है.
getAdSkippableState
getAdCampaignState() वापस बूलियन दिखाता है
अगर विज्ञापन को अभी स्किप किया जा सकता है, तो यह वैल्यू 'सही' के तौर पर दिखती है. जब यह वैल्यू बदलती है,
तो StreamManager,
StreamEvent.SKIPPABLE_STATE_CHANGED इवेंट को ट्रिगर करता है.
- सामान लौटाना
-
booleanअगर विज्ञापन अभी स्किप किया जा सकता है, तो सही है. अगर ऐसा नहीं है, तो गलत है.
loadStreamMetadata
loadStreamMetadata()
SDK टूल से, विज्ञापन के मेटाडेटा को लोड करने का अनुरोध करता है और फिर StreamEvent.LOADED को ब्रॉडकास्ट करता है. तीसरे पक्ष के वीडियो स्टिचर से स्ट्रीम मेनिफ़ेस्ट मिलने के बाद, इसे मैन्युअल रूप से ट्रिगर किया जाना चाहिए. इसका इस्तेमाल सिर्फ़ तीसरे पक्ष के वीडियो स्टिचर के साथ पॉड सर्विंग के लिए किया जाता है. साथ ही, अन्य स्ट्रीम के अनुरोध के लिए इसका इस्तेमाल नहीं किया जा सकता.
onTimedMetadata
onTimedMetadata(metadata)
प्रोसेस किए गए मेटाडेटा की डिक्शनरी में पास. शब्दकोश में वैल्यू के तौर पर उपयोगकर्ता की तय की गई मेटाडेटा स्ट्रिंग वाली 'TXXX' कुंजी होनी चाहिए. अगर आपका प्लेयर मूल मेटाडेटा उपलब्ध कराता है, तो इसके बजाय StreamManager.processMetadata को कॉल करें.
पैरामीटर |
|
|---|---|
|
मेटाडेटा |
ऑब्जेक्ट मेटाडेटा का शब्दकोश. मान शून्य नहीं होना चाहिए. |
previousCuePointForStreamTime
beforeCuePointForStreamTime(streamTime) CuePoint लौटाता है
दिए गए स्ट्रीम समय के लिए पिछला क्यूपॉइंट लौटाता है. अगर ऐसा कोई क्यूपॉइंट मौजूद नहीं है, तो शून्य दिखाता है. इसका इस्तेमाल स्नैप बैक जैसी सुविधाओं को लागू करने के लिए किया जाता है. जब पब्लिशर को पता चलता है कि उपयोगकर्ता ने उपयोगकर्ता को, विज्ञापन के लिए ब्रेक पर वापस जाना है, तो इसे कॉल किया जाता है.
पैरामीटर |
|
|---|---|
|
streamTime |
नंबर के मुताबिक स्ट्रीम करना था. |
- सामान लौटाना
-
स्ट्रीम के दिए गए समय के लिए पिछला क्यूपॉइंट
nullable CuePoint.
processMetadata
processMetadata(type, data, timestamp)
लाइव स्ट्रीम के लिए, तय किए गए समय पर मेटाडेटा को प्रोसेस करता है. अगर आपका वीडियो प्लेयर, टाइमस्टैंप के साथ बिना पार्स किया गया मेटाडेटा उपलब्ध कराता है, तो इसका इस्तेमाल करें. अगर ऐसा नहीं है, तो StreamManager.onTimedMetadata को कॉल करें.
पैरामीटर |
|
|---|---|
|
टाइप |
स्ट्रिंग मेटाडेटा का टाइप. HLS के लिए 'ID3' होना चाहिए या DASH के लिए इवेंट मैसेज स्कीम आईडी यूआरआई. |
|
डेटा |
(गैर-शून्य Uint8Array या स्ट्रिंग) रॉ टैग डेटा. आईडी3 के लिए, टैग का पूरा रॉ डेटा होना चाहिए. DASH इवेंट मैसेज के लिए, यह मैसेज डेटा स्ट्रिंग है. |
|
timestamp |
नंबर डेटा प्रोसेस करने में लगने वाला समय (सेकंड में). DASH के लिए, यह इवेंट मैसेज के शुरू होने का समय है. |
replaceAdTagParameters
replaceAdTagParameters(adTagParameters)
यह किसी लाइव स्ट्रीम के लिए, आने वाले समय में विज्ञापन अनुरोधों के लिए इस्तेमाल किए जाने वाले सभी विज्ञापन टैग पैरामीटर को बदलता है.
पैरामीटर |
|
|---|---|
|
adTagParameters |
स्ट्रिंग प्रॉपर्टी वाला ऑब्जेक्ट नए विज्ञापन टैग के पैरामीटर. स्ट्रिंग की वैल्यू होनी चाहिए. मान शून्य नहीं होना चाहिए. |
requestStream
requestStream(streamRequest)
दिए गए स्ट्रीम पैरामीटर का इस्तेमाल करके, किसी स्ट्रीम को लोड करने का अनुरोध करता है.
पैरामीटर |
|
|---|---|
|
streamRequest |
में स्ट्रीम मेटाडेटा लोड करने के लिए पैरामीटर मौजूद हैं. मान शून्य नहीं होना चाहिए. |
रीसेट कराे
रीसेट करें()
स्ट्रीम मैनेजर को रीसेट करता है और किसी भी लगातार पोल को हटा देता है.
setClickElement
setClickElement(clickElement)
विज्ञापनों पर क्लिक थ्रू एलिमेंट सेट करता है. विज्ञापन के चलने के दौरान इस एलिमेंट का इस्तेमाल, क्लिक या टैप रिसीव करने वाले के तौर पर किया जाता है. इसकी वजह से, हो सकता है कि आप नेविगेट करके मौजूदा पेज से हट जाएं. इस सुविधा को अब बंद कर दिया गया है. इसके बजाय, StreamManager में adUiElement को पास किया जाना चाहिए. अगर StreamManager कंस्ट्रक्टर को कोई adUiElement दिया जाता है, तो यह तरीका नो-ऑप बन जाता है.
पैरामीटर |
|
|---|---|
|
clickElement |
कौन-कौन सी चीज़ें शामिल हैं विज्ञापन को क्लिक मिलने के तौर पर इस्तेमाल किया गया एलिमेंट. वैल्यू शून्य हो सकती है. |
- बहिष्कृत किया गया
- इसके बजाय, StreamManager कंस्ट्रक्टर को adUiElement उपलब्ध कराएं.
streamTimeForContentTime
StreamTimeForContentTime(contentTime) संख्या दिखाता है
दिए गए कॉन्टेंट समय के लिए विज्ञापनों के साथ स्ट्रीम का समय दिखाता है. लाइव स्ट्रीम के लिए कॉन्टेंट के दिए गए समय की जानकारी देता है.
पैरामीटर |
|
|---|---|
|
contentTime |
नंबर बिना किसी विज्ञापन के कॉन्टेंट कितने समय तक देखा जा सकता है (सेकंड में). |
- सामान लौटाना
-
numberविज्ञापन दिखाए जाने के बाद, दिए गए कॉन्टेंट के समय के हिसाब से स्ट्रीम का समय.