IMA DAI SDK একটি ন্যূনতম HbbTV ভিডিও প্লেয়ার অ্যাপে ইন্টিগ্রেশন সমর্থন করে৷ IMA DAI SDK একটি ব্রডকাস্ট কন্টেন্ট স্ট্রিমের সাথে একটি ব্রডব্যান্ড বিজ্ঞাপন স্ট্রিমের জন্য Google অ্যাড ম্যানেজার চাহিদাকে সক্ষম করে৷ এই নির্দেশিকা সম্প্রচার স্ট্রীম থেকে বিজ্ঞাপন ইভেন্ট ডেটার উপর ভিত্তি করে একটি বিজ্ঞাপন ম্যানিফেস্ট লোড করা কভার করে৷
একটি সম্পূর্ণ নমুনা ইন্টিগ্রেশন সহ দেখতে বা অনুসরণ করতে, IMA HTML5 DAI SDK-এর সাথে HbbTV লিনিয়ার স্যাম্পল অ্যাপটি ডাউনলোড করুন। পুরানো টিভি ডিভাইসগুলিকে সমর্থন করার জন্য, এই নির্দেশিকা এবং GitHub নমুনা অ্যাপটি ES5 JavaScript-এ রয়েছে৷
অন্যান্য নন-HbbTV প্ল্যাটফর্মের সাথে একীভূত করার তথ্যের জন্য, ইন্টারেক্টিভ মিডিয়া বিজ্ঞাপন SDK দেখুন।
পূর্বশর্ত
এই নির্দেশিকাটি চালিয়ে যাওয়ার আগে, নিশ্চিত করুন যে আপনার নিম্নলিখিতগুলি রয়েছে:
- IMA DAI ব্যবহার করতে, আপনার একটি Ad Manager 360 Advanced অ্যাকাউন্ট থাকতে হবে। আপনার যদি অ্যাড ম্যানেজার অ্যাকাউন্ট থাকে, তাহলে আরও বিশদ বিবরণের জন্য আপনার অ্যাকাউন্ট পরিচালকের সাথে যোগাযোগ করুন। অ্যাড ম্যানেজারের জন্য সাইন আপ করার বিষয়ে তথ্যের জন্য, অ্যাড ম্যানেজার সহায়তা কেন্দ্রে যান।
- একটি HbbTV অ্যাপ মিডিয়া প্লেব্যাকের জন্য সম্প্রচার বস্তুর সাথে ইন্টারঅ্যাক্ট করছে। আরো বিস্তারিত জানার জন্য, HbbTV সম্প্রচার AV অবজেক্ট দেখুন।
- একটি dash.js সংস্করণ যা প্রিলোডিং সমর্থন করে। আমরা 4.6.0 বা তার পরবর্তী সংস্করণ ব্যবহার করার পরামর্শ দিই।
- অ্যাপ্লিকেশন হোস্ট করার জন্য একটি ওয়েব সার্ভার।
- একটি 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: বিজ্ঞাপনের অনুরোধ করার জন্য অ্যাড ম্যানেজার নেটওয়ার্ক কোড। -
CUSTOM_ASSET_KEY: অ্যাড ম্যানেজার কাস্টম অ্যাসেট কী DAI-এর জন্য লাইভস্ট্রিম সেট আপ করার প্রক্রিয়া চলাকালীন জেনারেট হয়েছে।
অ্যাপ্লিকেশন ফাইল কাঠামো তৈরি করুন
এই নির্দেশিকাটি 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://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 প্লেয়ার শুরু এবং নিয়ন্ত্রণ করতে একটি ভিডিও প্লেয়ার র্যাপার ক্লাস তৈরি করুন।