পড সার্ভিং রিডাইরেক্টের জন্য ক্লায়েন্টকে প্রস্তুত করা

এই গাইডে Pod পরিবেশন API এবং আপনার ম্যানিফেস্ট ম্যানিপুলেটর সহ HLS বা DASH লাইভস্ট্রিম লোড করার জন্য একটি ক্লায়েন্ট অ্যাপ্লিকেশন ডেভেলপ করার বিষয়ে আলোচনা করা হয়েছে।

পূর্বশর্ত

চালিয়ে যাওয়ার আগে, আপনার কাছে নিম্নলিখিতগুলি থাকতে হবে:

স্ট্রিম করার অনুরোধ করা

আপনার ব্যবহারকারী কোনও স্ট্রিম বেছে নিলে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. লাইভস্ট্রিম পরিষেবা পদ্ধতিতে POST অনুরোধ করুন। আরও জানতে, পদ্ধতি: স্ট্রিম দেখুন।

  2. application/x-www-form-urlencoded বা application/json ফর্ম্যাটে বিজ্ঞাপন টার্গেটিং প্যারামিটার পাস করুন। এই অনুরোধ Google DAI-এর সাথে একটি স্ট্রিম সেশন রেজিস্টার করে।

    নিম্নলিখিত উদাহরণটি একটি স্ট্রিম অনুরোধ করে:

    ফর্ম এনকোডিং

    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 কোয়েরি প্যারামিটার বাদ দিন। এই প্রসেসের মাধ্যমে সার্ভার স্ট্রিমের ডিজিটাল ভিডিও রেকর্ডার (DVR) উইন্ডোর জন্য সম্পূর্ণ মেটাডেটা ফেরত পাঠাতে পারে। DVR উইন্ডোতে ব্রডকাস্টের টাইমফ্রেম থাকে যা দর্শক রিওয়াইন্ড করে দেখতে পারেন। উত্তরে একটি 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 ভ্যালু পাঠান।

আপনার ভিডিও প্লেয়ারে স্ট্রিম লোড করুন

রেজিস্ট্রেশন রেসপন্স থেকে সেশন আইডি পাওয়ার পরে, আপনার ম্যানিফেস্ট ম্যানিপুলেটরে আইডি পাস করুন অথবা ভিডিও প্লেয়ারে স্ট্রিম লোড করার জন্য ম্যানিফেস্ট URL তৈরি করুন।

সেশন আইডি পাস করতে, আপনার ম্যানিফেস্ট ম্যানিপুলেটর ডকুমেন্টেশন দেখুন। আপনি যদি ম্যানিফেস্ট ম্যানিপুলেটর ডেভেলপ করেন, তাহলে লাইভ স্ট্রিমের জন্য ম্যানিফেস্ট ম্যানিপুলেটর দেখুন।

নিম্নলিখিত উদাহরণটি একটি ম্যানিফেস্ট URL অ্যাসেম্বল করে:

https://<your_manifest_manipulator_url>/manifest.m3u8?DAI_stream_ID=SESSION_ID&network_code=NETWORK_CODE&DAI_custom_asset_key=CUSTOM_ASSET_KEY"

আপনার প্লেয়ার রেডি হয়ে গেলে, প্লেব্যাক শুরু করুন।

বিজ্ঞাপন ইভেন্টের জন্য শুনুন

টাইমড মেটাডেটার জন্য আপনার স্ট্রিমের কন্টেনার ফর্ম্যাট চেক করুন:

  • ট্রান্সপোর্ট স্ট্রিম (TS) কন্টেনার সহ HLS স্ট্রিম, টাইমড মেটাডেটা বহন করার জন্য টাইমড ID3 ট্যাগ ব্যবহার করে। বিস্তারিত জানতে, HTTP লাইভ স্ট্রিমিং (HLS) সহ কমন মিডিয়া অ্যাপ্লিকেশন ফর্ম্যাট সম্পর্কে দেখুন।

  • DASH স্ট্রিমে ম্যানিফেস্টে ইভেন্ট নির্দিষ্ট করতে EventStream এলিমেন্ট ব্যবহার করা হয়।

  • DASH স্ট্রিমে InbandEventStream এলিমেন্ট ব্যবহার করা হয় যখন সেগমেন্টে ID3 ট্যাগ সহ পেলোড ডেটার জন্য ইভেন্ট মেসেজ (emsg) বক্স থাকে। বিস্তারিত জানতে, InbandEventStream দেখুন।

  • DASH ও HLS সহ CMAF স্ট্রিমে ID3 ট্যাগ সহ emsg বক্স ব্যবহার করা হয়।

আপনার স্ট্রিম থেকে ID3 ট্যাগ ফিরিয়ে আনতে, ভিডিও প্লেয়ারের নির্দেশিকা দেখুন। আরও জানতে, টাইমড মেটাডেটা গাইড দেখুন

ID3 ট্যাগ থেকে বিজ্ঞাপন ইভেন্ট আইডি ফিরিয়ে আনতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. urn:google:dai:2018 বা https://aomedia.org/emsg/ID3-এর সাথে scheme_id_uri-এর মাধ্যমে ইভেন্ট ফিল্টার করুন।
  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. TXXXgoogle_{ad_event_ID} ফর্ম্যাট সহ ID3 ট্যাগ ফিল্টার করুন:

    TXXXgoogle_1022389921
    

বিজ্ঞাপন ইভেন্ট ডেটা দেখান

TagSegment অবজেক্টটি খুঁজতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. বিজ্ঞাপন মেটাডেটা পোল করুন থেকে বিজ্ঞাপন মেটাডেটা tags অবজেক্ট ফিরিয়ে আনুন। tags অবজেক্ট হল TagSegment অবজেক্টের একটি অ্যারে।

  2. progress ধরনের TagSegment অবজেক্ট খুঁজতে সম্পূর্ণ বিজ্ঞাপন ইভেন্ট আইডি ব্যবহার করুন।

  3. অন্য ধরনের TagSegment অবজেক্ট খুঁজতে বিজ্ঞাপন ইভেন্ট আইডির প্রথম ১৭টি অক্ষর ব্যবহার করুন।

    আপনার ক্লায়েন্ট অ্যাপ নির্দিষ্ট সময় অন্তর বিজ্ঞাপনের মেটাডেটা পোল করে বলে, আপনার ভিডিও প্লেয়ার স্ট্রিমে 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 ইভেন্ট বাতিল করে দেয় এবং এইসব ইভেন্ট ঘনঘন পাঠালে আপনার অ্যাপের পারফর্ম্যান্সের উপর প্রভাব পড়তে পারে।

কোনও বিজ্ঞাপন ইভেন্টের সম্পূর্ণ মিডিয়া যাচাইকরণ URL তৈরি করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. স্ট্রিম রেসপন্স থেকে, সম্পূর্ণ বিজ্ঞাপন ইভেন্ট আইডি media_verification_url ভ্যালুতে যোগ করুন।

  2. সম্পূর্ণ 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 ত্রুটি কোড পাবেন।

আপনি স্ট্রিম অ্যাক্টিভিটি মনিটর (SAM) ব্যবহার করে সব বিজ্ঞাপন ইভেন্টের ঐতিহাসিক লগ পরীক্ষা করতে পারেন। আরও বিবরণের জন্য, লাইভস্ট্রিম মনিটর করা ও সমস্যার সমাধান করা দেখুন