क्लाइंट को पॉड सर्विंग रीडायरेक्ट के लिए तैयार करना

इस गाइड में, पॉड सर्विंग एपीआई और मेनिफ़ेस्ट मेनिप्युलेटर की मदद से, एचएलएस या DASH लाइव स्ट्रीम लोड करने के लिए क्लाइंट ऐप्लिकेशन बनाने का तरीका बताया गया है.

ज़रूरी शर्तें

जारी रखने के लिए, आपके पास ये चीज़ें होनी चाहिए:

स्ट्रीम का अनुरोध करना

जब आपका उपयोगकर्ता कोई स्ट्रीम चुनता है, तो यह तरीका अपनाएं:

  1. लाइव स्ट्रीम सेवा के तरीके के लिए, POST अनुरोध करें. ज़्यादा जानकारी के लिए, तरीका: स्ट्रीम देखें.

  2. विज्ञापन टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) के पैरामीटर, 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
    }
    
  3. JSON रिस्पॉन्स में, स्ट्रीम सेशन आईडी ढूंढें और आगे के चरणों के लिए अन्य डेटा सेव करें.

पोल विज्ञापन का मेटाडेटा

विज्ञापन के मेटाडेटा को पोल करने के लिए, यह तरीका अपनाएं:

  1. स्ट्रीम रजिस्ट्रेशन के रिस्पॉन्स से metadata_url वैल्यू पढ़ें.

  2. metadata_url एंडपॉइंट पर शुरुआती GET अनुरोध करें.

    • delta_token क्वेरी पैरामीटर को हटा दें. इस प्रोसेस की मदद से, सर्वर स्ट्रीम की डिजिटल वीडियो रिकॉर्डर (डीवीआर) विंडो के लिए पूरा मेटाडेटा दिखा पाता है. डीवीआर की तय सीमा में, ब्रॉडकास्ट की वह समयसीमा शामिल होती है जिसमें दर्शक वीडियो को पीछे करके देख सकते हैं. रिस्पॉन्स में next_delta_token फ़ील्ड शामिल होता है.
  3. बैंडविड्थ को ऑप्टिमाइज़ करने के लिए, सबसे हाल के रिस्पॉन्स से next_delta_token वैल्यू को सेव करें.

  4. अपने अगले अनुरोध पर, उस वैल्यू को 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
        },
        ...
      }
    }
    
  5. tags ऑब्जेक्ट को सेव करें और अपडेट को अपनी लोकल कैश मेमोरी में मर्ज करें. अगर obsolete_ad_break_ids पैरामीटर मौजूद है, तो अपनी कैश मेमोरी से विज्ञापन के लिए ब्रेक और उनसे जुड़े विज्ञापन और टैग हटाएं.

  6. नियमित तौर पर मेटाडेटा का अनुरोध करने के लिए, 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 टैग से विज्ञापन इवेंट आईडी पाने के लिए, यह तरीका अपनाएं:

  1. इवेंट को scheme_id_uri के हिसाब से फ़िल्टर करें. इसके लिए, urn:google:dai:2018 या https://aomedia.org/emsg/ID3 का इस्तेमाल करें.
  2. message_data फ़ील्ड से बाइट कलेक्शन को निकालें.

    नीचे दिए गए उदाहरण में, emsg डेटा को JSON में डिकोड किया गया है:

    {
      "scheme_id_uri": "https://developer.apple.com/streaming/emsg-id3",
      "presentation_time": 27554,
      "timescale": 1000,
      "message_data": "ID3TXXXgoogle_1022389921",
      ...
    }
    
  3. ID3 टैग को TXXXgoogle_{ad_event_ID} फ़ॉर्मैट के हिसाब से फ़िल्टर करें:

    TXXXgoogle_1022389921
    

विज्ञापन इवेंट का डेटा दिखाना

TagSegment ऑब्जेक्ट ढूंढने के लिए, यह तरीका अपनाएं:

  1. पोल विज्ञापन के मेटाडेटा से, विज्ञापन का मेटाडेटा tags ऑब्जेक्ट वापस पाएं. tags ऑब्जेक्ट, TagSegment ऑब्जेक्ट का कलेक्शन है.

  2. progress टाइप वाले TagSegment ऑब्जेक्ट को ढूंढने के लिए, विज्ञापन इवेंट के पूरे आईडी का इस्तेमाल करें.

  3. अन्य टाइप के TagSegment ऑब्जेक्ट को ढूंढने के लिए, विज्ञापन इवेंट आईडी के पहले 17 वर्णों का इस्तेमाल करें.

    आपका क्लाइंट ऐप्लिकेशन, विज्ञापन के मेटाडेटा को समय-समय पर पोल करता है. इसलिए, वीडियो प्लेयर को स्ट्रीम में ID3 टैग मिलने और उससे जुड़ा मेटाडेटा उपलब्ध होने के बीच देरी हो सकती है. अगर आपके क्लाइंट ऐप्लिकेशन को सेव किए गए टैग में ID3 टैग नहीं मिलता है, तो टैग को सूची में रखें. साथ ही, अगले मेटाडेटा पोल के बाद टैग को फिर से प्रोसेस करें. प्रोसेस पूरी होने तक टैग को सूची में रखें.

  4. TagSegment मिलने के बाद, विज्ञापन के मेटाडेटा ad_breaks ऑब्जेक्ट में AdBreak ऑब्जेक्ट ढूंढने के लिए, ad_break_id प्रॉपर्टी को कुंजी के तौर पर इस्तेमाल करें.

    इस उदाहरण में, AdBreak ऑब्जेक्ट को ढूंढा गया है:

    {
      "type":"mid",
      "duration":15,
      "ads":1
    }
    
  5. विज्ञापन के लिए ब्रेक में विज्ञापन की पोज़िशन के बारे में जानकारी दिखाने के लिए, TagSegment और AdBreak डेटा का इस्तेमाल करें. उदाहरण के लिए, Ad 1 of 3.

विज्ञापन के इवेंट के सिग्नल भेजना

progress टाइप को छोड़कर, हर विज्ञापन इवेंट के लिए, विज्ञापन के इवेंट का सिग्नल भेजें. Google DAI, progress इवेंट को खारिज कर देता है. इन इवेंट को बार-बार भेजने से, आपके ऐप्लिकेशन की परफ़ॉर्मेंस पर असर पड़ सकता है.

किसी विज्ञापन इवेंट के लिए, मीडिया की पुष्टि करने वाला पूरा यूआरएल जनरेट करने के लिए, यह तरीका अपनाएं:

  1. स्ट्रीम रिस्पॉन्स से, पूरे विज्ञापन इवेंट आईडी को media_verification_url वैल्यू में जोड़ें.

  2. पूरे यूआरएल के साथ 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 गड़बड़ी का कोड मिलेगा.

स्ट्रीम ऐक्टिविटी मॉनिटर (एसएएम) का इस्तेमाल करके, सभी विज्ञापन इवेंट का पुराना लॉग देखा जा सकता है. ज़्यादा जानकारी के लिए, लाइव स्ट्रीम को मॉनिटर करना और उससे जुड़ी समस्या हल करना लेख पढ़ें