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