इस गाइड में, पॉड सर्विंग एपीआई और मेनिफ़ेस्ट मेनिप्युलेटर की मदद से, एचएलएस या DASH लाइव स्ट्रीम लोड करने के लिए क्लाइंट ऐप्लिकेशन बनाने का तरीका बताया गया है.
ज़रूरी शर्तें
जारी रखने के लिए, आपके पास ये चीज़ें होनी चाहिए:
Pod serving redirectडीएआई टाइप के साथ कॉन्फ़िगर किए गए लाइव स्ट्रीम इवेंट के लिए, कस्टम ऐसेट कुंजी. यह कुंजी पाने के लिए, यह तरीका अपनाएं:LiveStreamEventऑब्जेक्ट औरPOD_SERVING_REDIRECTenum वैल्यू पर सेट की गईdynamicAdInsertionTypeप्रॉपर्टी के साथLiveStreamEventService.createLiveStreamEventsतरीके को कॉल करने के लिए, SOAP API क्लाइंट लाइब्रेरी का इस्तेमाल करें. सभी क्लाइंट लाइब्रेरी के लिए, क्लाइंट लाइब्रेरी और कोड का उदाहरण देखें.
देखें कि आपके प्लैटफ़ॉर्म के लिए, Interactive Media Ads (IMA) SDK उपलब्ध है या नहीं. हमारा सुझाव है कि रेवेन्यू बढ़ाने के लिए, IMA SDK का इस्तेमाल करें. ज़्यादा जानकारी के लिए, डीएआई के लिए IMA SDK सेट अप करना लेख पढ़ें.
स्ट्रीम का अनुरोध करना
जब आपका उपयोगकर्ता कोई स्ट्रीम चुनता है, तो यह तरीका अपनाएं:
लाइव स्ट्रीम सेवा के तरीके के लिए,
POSTअनुरोध करें. ज़्यादा जानकारी के लिए, तरीका: स्ट्रीम देखें.विज्ञापन टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) के पैरामीटर,
application/x-www-form-urlencodedयाapplication/jsonफ़ॉर्मैट में पास करें. यह अनुरोध, Google डीएआई के साथ स्ट्रीम सेशन को रजिस्टर करता है.यहां दिए गए उदाहरण में, स्ट्रीम का अनुरोध करने का तरीका बताया गया है:
फ़ॉर्म एन्कोडिंग
const url = `https://dai.google.com/ssai/pods/api/v1/` + `network/NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/stream`; const params = new URLSearchParams({ cust_params: 'section=sports&page=golf,tennis' }).toString(); const response = await fetch(url, { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: params }); console.log(await response.json());JSON एन्कोडिंग
const url = `https://dai.google.com/ssai/pods/api/v1/` + `network/NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/stream`; const response = await fetch(url, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ cust_params: { section: 'sports', page: 'golf,tennis' } }) }); console.log(await response.json());अगर यह प्रोसेस पूरी हो जाती है, तो आपको इस तरह का आउटपुट दिखेगा:
{ "stream_id": "c4a5dad5-aaa8-4550-8acb-7cda3cdb21bb:DLS", "media_verification_url": "https://dai.google.com/view/.../event/c14aZDWtQg-ZwQaEGl6bYA/media/", "metadata_url": "https://dai.google.com/linear/pods/hls/.../metadata", "session_update_url": "https://dai.google.com/linear/.../session", "polling_frequency": 10 }JSON रिस्पॉन्स में, स्ट्रीम सेशन आईडी ढूंढें और आगे के चरणों के लिए अन्य डेटा सेव करें.
पोल विज्ञापन का मेटाडेटा
विज्ञापन के मेटाडेटा को पोल करने के लिए, यह तरीका अपनाएं:
स्ट्रीम रजिस्ट्रेशन के रिस्पॉन्स से
metadata_urlवैल्यू पढ़ें.metadata_urlएंडपॉइंट पर शुरुआतीGETअनुरोध करें.delta_tokenक्वेरी पैरामीटर को हटा दें. इस प्रोसेस की मदद से, सर्वर स्ट्रीम की डिजिटल वीडियो रिकॉर्डर (डीवीआर) विंडो के लिए पूरा मेटाडेटा दिखा पाता है. डीवीआर की तय सीमा में, ब्रॉडकास्ट की वह समयसीमा शामिल होती है जिसमें दर्शक वीडियो को पीछे करके देख सकते हैं. रिस्पॉन्स मेंnext_delta_tokenफ़ील्ड शामिल होता है.
बैंडविड्थ को ऑप्टिमाइज़ करने के लिए, सबसे हाल के रिस्पॉन्स से
next_delta_tokenवैल्यू को सेव करें.अपने अगले अनुरोध पर, उस वैल्यू को
delta_tokenक्वेरी पैरामीटर के तौर पर भेजें. सर्वर सिर्फ़ वह मेटाडेटा दिखाता है जो टोकन जनरेट होने के बाद बदला गया है. हमेशा वह टोकन भेजें जो आपको सबसे आखिर में मिला है. टोकन को पार्स करने, उसमें बदलाव करने या उसे बनाने की कोशिश न करें. ज़्यादा जानकारी के लिए, तरीका: मेटाडेटा देखें.यहां दिए गए उदाहरण में, विज्ञापन का मेटाडेटा फ़ेच करने का तरीका बताया गया है:
// Initial request (returns full metadata and next_delta_token) let response = await fetch(metadata_url); let metadata = await response.json(); let deltaToken = metadata.next_delta_token; // Subsequent request (returns only changes since deltaToken) if (deltaToken) { const url = new URL(metadata_url); url.searchParams.append('delta_token', deltaToken); response = await fetch(url.toString()); const deltaMetadata = await response.json(); // Merge deltaMetadata into your local cache mergeMetadata(metadata, deltaMetadata); deltaToken = deltaMetadata.next_delta_token; }अगर अनुरोध सही से काम करता है, ताे आपको PodMetadata रिस्पॉन्स मिलता है.
delta_tokenपैरामीटर देने पर, रिस्पॉन्स में सिर्फ़ वे विज्ञापन, विज्ञापन के लिए ब्रेक, और टैग शामिल होते हैं जिन्हें सर्वर ने टोकन जनरेट करने के बाद जोड़ा या अपडेट किया है. जवाब मेंnext_delta_tokenकी नई वैल्यू भी शामिल होती है. अगर विज्ञापन के लिए कोई ब्रेक पुराना हो गया है, तो जवाब में विज्ञापन के लिए ब्रेक की एकobsolete_ad_break_idsसूची भी शामिल होती है. इससे आपको पता चलता है कि आपको अपनी कैश मेमोरी से कौनसे ब्रेक हटाने हैं.{ "next_delta_token": "eyJyYW5nZXMiOlt7InMiOjEsImUiOjN9XX0", "obsolete_ad_break_ids": ["0003069407"], "tags":{ "google_1022389921":{ "ad":"0003069408_ad1", "ad_break_id":"0003069408", "type":"start" }, ... }, "ads":{ "0003069408_ad1":{ "ad_break_id":"0003069408", "position":1, "duration":10.01, "title":"External - Pod Midroll 1", "clickthrough_url":"https://.../", ... }, ... }, "ad_breaks":{ "0003069408":{ "type":"mid", "duration":30, "ads":3 }, ... } }tagsऑब्जेक्ट को सेव करें और अपडेट को अपनी लोकल कैश मेमोरी में मर्ज करें. अगरobsolete_ad_break_idsपैरामीटर मौजूद है, तो अपनी कैश मेमोरी से विज्ञापन के लिए ब्रेक और उनसे जुड़े विज्ञापन और टैग हटाएं.नियमित तौर पर मेटाडेटा का अनुरोध करने के लिए,
polling_frequencyवैल्यू का इस्तेमाल करके टाइमर सेट करें. हर पोल में,delta_tokenक्वेरी पैरामीटर के तौर पर, सबसे हाल के मेटाडेटा रिस्पॉन्स में मिलीnext_delta_tokenवैल्यू भेजें.
अपने वीडियो प्लेयर में स्ट्रीम लोड करना
रजिस्ट्रेशन के जवाब से सेशन आईडी मिलने के बाद, आईडी को अपने मेनिफ़ेस्ट मेनिप्युलेटर को पास करें या वीडियो प्लेयर में स्ट्रीम लोड करने के लिए, मेनिफ़ेस्ट यूआरएल बनाएं.
सेशन आईडी पास करने के लिए, मेनिफ़ेस्ट मेनिप्युलेटर का दस्तावेज़ देखें. अगर आपको मेनिफ़ेस्ट मेनिप्युलेटर बनाना है, तो लाइव स्ट्रीम के लिए मेनिफ़ेस्ट मेनिप्युलेटर देखें.
यहां दिए गए उदाहरण में, मेनिफ़ेस्ट यूआरएल को असेंबल किया गया है:
https://<your_manifest_manipulator_url>/manifest.m3u8?DAI_stream_ID=SESSION_ID&network_code=NETWORK_CODE&DAI_custom_asset_key=CUSTOM_ASSET_KEY"
जब आपका प्लेयर तैयार हो जाए, तब वीडियो चलाना शुरू करें.
विज्ञापन इवेंट को मॉनिटर करना
टाइमस्टैंप वाले मेटाडेटा के लिए, अपनी स्ट्रीम का कंटेनर फ़ॉर्मैट देखें:
ट्रांसपोर्ट स्ट्रीम (टीएस) कंटेनर वाली एचएलएस स्ट्रीम, टाइम किए गए मेटाडेटा को ले जाने के लिए, टाइम किए गए ID3 टैग का इस्तेमाल करती हैं. ज़्यादा जानकारी के लिए, एचटीटीपी लाइव स्ट्रीमिंग (एचएलएस) के साथ कॉमन मीडिया ऐप्लिकेशन फ़ॉर्मैट के बारे में जानकारी लेख पढ़ें.
DASH स्ट्रीम, मेनिफ़ेस्ट में इवेंट तय करने के लिए
EventStreamएलिमेंट का इस्तेमाल करती हैं.DASH स्ट्रीम,
InbandEventStreamएलिमेंट का इस्तेमाल तब करती हैं, जब सेगमेंट में पेलोड डेटा के लिए इवेंट मैसेज (emsg) बॉक्स शामिल होते हैं. इसमें ID3 टैग भी शामिल होते हैं. ज़्यादा जानकारी के लिए, InbandEventStream देखें.DASH और एचएलएस जैसी सीएमएएफ़ स्ट्रीम,
emsgबॉक्स का इस्तेमाल करती हैं. इनमें ID3 टैग होते हैं.
अपनी स्ट्रीम से ID3 टैग वापस पाने के लिए, अपने वीडियो प्लेयर की गाइड देखें. ज़्यादा जानकारी के लिए, टाइम किए गए मेटाडेटा को मैनेज करने की गाइड देखें
ID3 टैग से विज्ञापन इवेंट आईडी पाने के लिए, यह तरीका अपनाएं:
- इवेंट को
scheme_id_uriके हिसाब से फ़िल्टर करें. इसके लिए,urn:google:dai:2018याhttps://aomedia.org/emsg/ID3का इस्तेमाल करें. message_dataफ़ील्ड से बाइट कलेक्शन को निकालें.नीचे दिए गए उदाहरण में,
emsgडेटा को JSON में डिकोड किया गया है:{ "scheme_id_uri": "https://developer.apple.com/streaming/emsg-id3", "presentation_time": 27554, "timescale": 1000, "message_data": "ID3TXXXgoogle_1022389921", ... }ID3 टैग को
TXXXgoogle_{ad_event_ID}फ़ॉर्मैट के हिसाब से फ़िल्टर करें:TXXXgoogle_1022389921
विज्ञापन इवेंट का डेटा दिखाना
TagSegment
ऑब्जेक्ट ढूंढने के लिए, यह तरीका अपनाएं:
पोल विज्ञापन के मेटाडेटा से, विज्ञापन का मेटाडेटा
tagsऑब्जेक्ट वापस पाएं.tagsऑब्जेक्ट,TagSegmentऑब्जेक्ट का कलेक्शन है.progressटाइप वालेTagSegmentऑब्जेक्ट को ढूंढने के लिए, विज्ञापन इवेंट के पूरे आईडी का इस्तेमाल करें.अन्य टाइप के
TagSegmentऑब्जेक्ट को ढूंढने के लिए, विज्ञापन इवेंट आईडी के पहले 17 वर्णों का इस्तेमाल करें.आपका क्लाइंट ऐप्लिकेशन, विज्ञापन के मेटाडेटा को समय-समय पर पोल करता है. इसलिए, वीडियो प्लेयर को स्ट्रीम में ID3 टैग मिलने और उससे जुड़ा मेटाडेटा उपलब्ध होने के बीच देरी हो सकती है. अगर आपके क्लाइंट ऐप्लिकेशन को सेव किए गए टैग में ID3 टैग नहीं मिलता है, तो टैग को सूची में रखें. साथ ही, अगले मेटाडेटा पोल के बाद टैग को फिर से प्रोसेस करें. प्रोसेस पूरी होने तक टैग को सूची में रखें.
TagSegmentमिलने के बाद, विज्ञापन के मेटाडेटाad_breaksऑब्जेक्ट मेंAdBreakऑब्जेक्ट ढूंढने के लिए,ad_break_idप्रॉपर्टी को कुंजी के तौर पर इस्तेमाल करें.इस उदाहरण में,
AdBreakऑब्जेक्ट को ढूंढा गया है:{ "type":"mid", "duration":15, "ads":1 }विज्ञापन के लिए ब्रेक में विज्ञापन की पोज़िशन के बारे में जानकारी दिखाने के लिए,
TagSegmentऔरAdBreakडेटा का इस्तेमाल करें. उदाहरण के लिए,Ad 1 of 3.
विज्ञापन के इवेंट के सिग्नल भेजना
progress टाइप को छोड़कर, हर विज्ञापन इवेंट के लिए, विज्ञापन के इवेंट का सिग्नल भेजें.
Google DAI, progress इवेंट को खारिज कर देता है. इन इवेंट को बार-बार भेजने से, आपके ऐप्लिकेशन की परफ़ॉर्मेंस पर असर पड़ सकता है.
किसी विज्ञापन इवेंट के लिए, मीडिया की पुष्टि करने वाला पूरा यूआरएल जनरेट करने के लिए, यह तरीका अपनाएं:
स्ट्रीम रिस्पॉन्स से, पूरे विज्ञापन इवेंट आईडी को
media_verification_urlवैल्यू में जोड़ें.पूरे यूआरएल के साथ
GETअनुरोध करें:// media_verification_url: "https://dai.google.com/view/.../event/c14aZDWtQg-ZwQaEGl6bYA/media/" const completeUrl = `${media_verification_url}google_1022389921`; const response = await fetch(completeUrl);अगर अनुरोध पूरा हो जाता है, तो आपको कोड स्टेटस
202जवाब मिलता है. ऐसा न करने पर, आपको404गड़बड़ी का कोड मिलेगा.
स्ट्रीम ऐक्टिविटी मॉनिटर (एसएएम) का इस्तेमाल करके, सभी विज्ञापन इवेंट का पुराना लॉग देखा जा सकता है. ज़्यादा जानकारी के लिए, लाइव स्ट्रीम को मॉनिटर करना और उससे जुड़ी समस्या हल करना लेख पढ़ें