HbbTV-তে IMA SDK ব্যবহার শুরু করা

IMA DAI SDK, ন্যূনতম HbbTV ভিডিও প্লেয়ার অ্যাপে ইন্টিগ্রেশন সাপোর্ট করে। IMA DAI SDK, ব্রডকাস্ট কন্টেন্ট স্ট্রিমের সাথে ব্রডব্যান্ড বিজ্ঞাপন স্ট্রিমের জন্য Google Ad Manager-এর চাহিদা পূরণ করে। এই গাইডে ব্রডকাস্ট স্ট্রিম থেকে পাওয়া বিজ্ঞাপন ইভেন্ট ডেটার ভিত্তিতে বিজ্ঞাপন ম্যানিফেস্ট লোড করা সম্পর্কে আলোচনা করা হয়েছে।

সম্পূর্ণ স্যাম্পেল ইন্টিগ্রেশন দেখতে বা অনুসরণ করতে, IMA HTML5 DAI SDK সহ HbbTV লিনিয়ার স্যাম্পেল অ্যাপ ডাউনলোড করুন। পুরনো টিভি ডিভাইসে কাজ করার জন্য, এই গাইড এবং GitHub স্যাম্পেল অ্যাপ ES5 JavaScript-এ রয়েছে।

অন্যান্য নন-HbbTV প্ল্যাটফর্মের সাথে ইন্টিগ্রেট করার ব্যাপারে তথ্য পেতে, Interactive Media Ads SDK দেখুন।

পূর্বশর্ত

এই নির্দেশিকা অনুসরণ করার আগে, আপনার কাছে নিম্নলিখিতগুলি আছে কিনা তা কনফার্ম করুন:

  • IMA DAI ব্যবহার করতে হলে, আপনার একটি Ad Manager 360 Advanced অ্যাকাউন্ট থাকতে হবে। আপনার Ad Manager অ্যাকাউন্ট থাকলে, আরও বিস্তারিত বিবরণের জন্য আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন। Ad Manager-এ সাইন-আপ করার ব্যাপারে আরও তথ্য পেতে, Ad Manager সহায়তা কেন্দ্র দেখুন।
  • মিডিয়া প্লেব্যাকের জন্য ব্রডকাস্ট অবজেক্টের সাথে ইন্টার‍্যাক্ট করা HbbTV অ্যাপ। আরও বিবরণের জন্য, HbbTV ব্রডকাস্ট AV অবজেক্ট দেখুন।
  • dash.js-এর এমন একটি ভার্সন যাতে প্রিলোড করার সুবিধা আছে। আমরা ৪.৬.০ বা তার পরের ভার্সন ব্যবহার করার সাজেশন দিই।
  • অ্যাপ্লিকেশন হোস্ট করার জন্য একটি ওয়েব সার্ভার।
  • DVB ব্রডকাস্ট স্ট্রিম সহ একটি টেস্টিং এনভায়রনমেন্ট। আপনার টেস্টিং এনভায়রনমেন্ট সেট-আপ করার জন্য বিস্তারিত নির্দেশাবলী পেতে, HbbTV অ্যাপ্লিকেশন চালানো দেখুন।
    • ব্রডকাস্ট স্ট্রিম: কাস্টম অ্যাপ্লিকেশন ইনফরমেশন টেবিল (AIT) ডেটা সহ ব্রডকাস্ট স্ট্রিম প্রস্তুত করুন। এছাড়াও, টিভিতে রিসিভ করার জন্য ব্রডকাস্ট স্ট্রিম ট্রান্সমিট করার উপায় আপনার কাছে থাকতে হবে। আপনি ব্রডকাস্ট স্ট্রিম বা অন্যান্য পদ্ধতি ট্রান্সমিট করতে DVB মডিউলেটর ব্যবহার করতে পারেন।
    • ওয়েব সার্ভার: টিভি অ্যাক্সেস করতে পারে এমন ওয়েব সার্ভারে HbbTV অ্যাপ্লিকেশন হোস্ট করুন।
  • পড সার্ভিং ম্যানিফেস্ট ধরনের লাইভ স্ট্রিম ইভেন্ট। ইভেন্ট তৈরি করতে, DAI-এর জন্য লাইভ স্ট্রিম সেট-আপ করুন দেখুন।

মানানসই ব্রডকাস্ট স্ট্রিম তৈরি করা

আপনার ব্রডকাস্ট স্ট্রিমে HbbTV স্ট্রিম ইভেন্ট শুনতে আপনার HbbTV অ্যাপ broadcastContainer.addStreamEventListener() ব্যবহার করে। বিজ্ঞাপন সঠিকভাবে লোড ও প্লে করতে, আপনাকে নিম্নলিখিত ইভেন্টের ধরন সহ ব্রডকাস্ট স্ট্রিম সেট-আপ করতে হবে যাতে সংশ্লিষ্ট JSON স্ট্রিং পেলোড অন্তর্ভুক্ত থাকে:

  • AD_BREAK_EVENT_ANNOUNCE - {"type":"adBreakAnnounce", "pod_id":1,"duration":90, "offset":10}
  • AD_BREAK_EVENT_START - {"type":"adBreakStart"}
  • AD_BREAK_EVENT_END - {"type":"adBreakEnd"}

এইসব ইভেন্টের জন্য, streamEvent.type সহ JSON স্ট্রিং পেলোড অন্তর্ভুক্ত করুন। বিজ্ঞাপন প্রিলোড করার সুবিধা দিতে, AD_BREAK_EVENT_ANNOUNCE ইভেন্টে অবশ্যই streamEvent.duration এবং streamEvent.offset অন্তর্ভুক্ত থাকতে হবে। আরও তথ্যের জন্য, HbbTV স্ট্রিম ইভেন্ট শুনুন দেখুন। আপনার ব্রডকাস্ট স্ট্রিম সেট-আপ করতে, মাল্টিপ্লেক্সড MPEG ট্রান্সপোর্ট স্ট্রিম-এর উদাহরণ দেখুন। উদাহরণ স্ট্রিম ব্যবহার করতে, আপনার নিজস্ব স্ট্রিম সেট-আপের জন্য আপনাকে অবশ্যই অ্যাপ্লিকেশন তথ্য টেবিল URL আপডেট করতে হবে।

পড পরিবেশনকারী লাইভস্ট্রিম ইভেন্ট তৈরি করুন

আপনার HbbTV অ্যাপে বিজ্ঞাপন পরিবেশন করতে, আপনার একটি পড পরিবেশনকারী লাইভস্ট্রিম ইভেন্ট প্রয়োজন। ইভেন্ট সেট-আপ করার ব্যাপারে তথ্যের জন্য, DAI-এর জন্য লাইভ স্ট্রিম সেট-আপ করুন দেখুন। আপনার সেট-আপ করা স্ট্রিম অ্যাক্সেস করতে, অ্যাপে নিম্নলিখিত ভেরিয়েবল থাকতে হবে:

  • NETWORK_CODE: বিজ্ঞাপনের অনুরোধ করার জন্য Ad Manager নেটওয়ার্ক কোড।
  • CUSTOM_ASSET_KEY: DAI-এর জন্য লাইভস্ট্রিম সেট-আপ করার প্রসেস চলাকালীন Ad Manager কাস্টম অ্যাসেট কী তৈরি করা হয়েছে।

অ্যাপ্লিকেশন ফাইল স্ট্রাকচার তৈরি করুন

এই নির্দেশিকা IMA HbbTV স্যাম্পেল অ্যাপ-এর মতো একই ফাইল স্ট্রাকচার ব্যবহার করে। এই নির্দেশিকা অনুসরণ করতে, নিম্নলিখিত ফাইলগুলি তৈরি করুন:

  • index.html: আপনার অ্যাপের জন্য HTML ইন্ডেক্স।
  • Style.css: আপনার অ্যাপের জন্য CSS স্টাইলিং।
  • application.js: প্রধান JS এন্ট্রি পয়েন্ট। প্লেস্টেট ও বিজ্ঞাপন বিরতি ম্যানেজ করে।
  • video_player.js: বিজ্ঞাপন প্লেব্যাকের জন্য ব্যবহৃত dash.js প্লেয়ার ম্যানেজ করে।
  • ads_manager.js: IMA সেট-আপ, স্ট্রিম অনুরোধ ও ইভেন্ট ম্যানেজ করে।

ads_manager.js IMA DAI SDK সেট-আপ করে। নিম্নলিখিত কম্পোনেন্টগুলি IMA DAI SDK প্রয়োগ করে:

  • PodStreamRequest: Google-এর বিজ্ঞাপন সার্ভারে স্ট্রিম অনুরোধের সংজ্ঞা নির্ধারণ করে এমন অবজেক্ট।
  • StreamManager: একটি অবজেক্ট যা ডায়নামিক বিজ্ঞাপন ইনসার্শন স্ট্রিম এবং DAI ব্যাকএন্ডের সাথে ইন্টার‍্যাকশন ম্যানেজ করে। এছাড়াও, স্ট্রিম ম্যানেজার ট্র্যাকিং পিং ম্যানেজ করে এবং প্রকাশককে স্ট্রিম ও বিজ্ঞাপন ইভেন্ট ফরওয়ার্ড করে।

আপনার টেস্টিং এনভায়রনমেন্ট সেট-আপ করার ব্যাপারে বিস্তারিত নির্দেশাবলীর জন্য, HbbTV অ্যাপ্লিকেশন চালানো সংক্রান্ত এই নির্দেশিকা দেখুন।

IMA DAI SDK এবং DASH.js লোড করুন

ব্রডকাস্ট বিজ্ঞাপন স্ট্রিম প্লেব্যাক শুরু করতে, আপনার অ্যাপে IMA DAI SDK এবং dash.js লোড করুন। application.js ট্যাগের আগে, index.html-এ স্ক্রিপ্ট ট্যাগ ব্যবহার করে dash.js এবং IMA ফ্রেমওয়ার্ক যোগ করুন।

<script src="https://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.2.0/crypto-js.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/dashjs@latest/dist/dash.all.min.js"></script>
<script src="//imasdk.googleapis.com/js/sdkloader/ima3_dai.js"></script>

এরপর, dash.js প্লেয়ার শুরু ও কন্ট্রোল করতে ভিডিও প্লেয়ার র‍্যাপার ক্লাস তৈরি করুন।

পরবর্তী
প্লেয়ার ক্লাস সেট-আপ করা