এই নির্দেশিকা থেকে জানতে পারবেন যে কীভাবে IMA DAI SDK-কে ভিডিও প্লেয়ার অ্যাপে ইন্টিগ্রেট করতে হয়। আপনি যদি সম্পূর্ণ স্যাম্পেল ইন্টিগ্রেশন দেখতে বা অনুসরণ করতে চান, তাহলে GitHub থেকে সহজ উদাহরণ ডাউনলোড করুন।
IMA DAI ওভারভিউ
IMA DAI SDK প্রয়োগ করার ক্ষেত্রে দুটি প্রধান কম্পোনেন্ট থাকে, যা এই নির্দেশিকায় দেখানো হয়েছে:
StreamRequest— হয়VODStreamRequestঅথবাLiveStreamRequest: একটি অবজেক্ট যা স্ট্রিম অনুরোধকে সংজ্ঞায়িত করে। স্ট্রিম সংক্রান্ত অনুরোধ চাহিদা অনুসার ভিডিও বা লাইভ স্ট্রিমের জন্য হতে পারে। লাইভ স্ট্রিম অনুরোধে অ্যাসেট কী উল্লেখ করা থাকে, যেখানে VOD অনুরোধে CMS আইডি ও ভিডিও আইডি উল্লেখ করা থাকে। উভয় ধরনের অনুরোধে নির্দিষ্ট স্ট্রিম অ্যাক্সেস করার জন্য প্রয়োজনীয় API কী এবং Google Ad Manager সেটিংসে উল্লেখ করা বিজ্ঞাপন শনাক্তকারী ম্যানেজ করার জন্য IMA SDK-এর Google Ad Manager নেটওয়ার্ক কোড ঐচ্ছিকভাবে অন্তর্ভুক্ত থাকতে পারে।StreamManager: একটি অবজেক্ট যা ডায়নামিক বিজ্ঞাপন ইনসার্শন স্ট্রিম এবং DAI ব্যাকএন্ডের সাথে ইন্টার্যাকশন ম্যানেজ করে। এছাড়াও, স্ট্রিম ম্যানেজার ট্র্যাকিং পিং ম্যানেজ করে এবং স্ট্রিম ও বিজ্ঞাপন ইভেন্ট প্রকাশকের কাছে ফরওয়ার্ড করে।
পূর্বশর্ত
- তিনটি খালি ফাইল
- dai.html
- dai.css
- dai.js
- আপনার কম্পিউটারে Python ইনস্টল করা থাকতে হবে অথবা পরীক্ষার জন্য ব্যবহার করার জন্য একটি ওয়েব সার্ভার থাকতে হবে
ডেভেলপমেন্ট সার্ভার চালু করুন
যে পৃষ্ঠা থেকে IMA DAI SDK লোড করা হয়, সেই একই প্রোটোকল ব্যবহার করে এটি ডিপেন্ডেন্সি লোড করে বলে, আপনার অ্যাপ পরীক্ষা করার জন্য আপনাকে একটি ওয়েব সার্ভার ব্যবহার করতে হবে। স্থানীয় ডেভেলপমেন্ট সার্ভার শুরু করার একটি দ্রুত উপায় হল Python-এর বিল্ট-ইন সার্ভার ব্যবহার করা।
কমান্ড লাইন ব্যবহার করে, আপনার
index.htmlফাইল আছে এমন ডিরেক্টরি থেকে রান করুন:python -m http.server 8000ওয়েব ব্রাউজার ব্যবহার করে
http://localhost:8000/-এ যানএছাড়াও, আপনি অন্য যেকোনও ওয়েব সার্ভার ব্যবহার করতে পারেন, যেমন Apache HTTP সার্ভার।
ভিডিও প্লেয়ার তৈরি করুন
প্রথমে, HTML5 ভিডিও এলিমেন্ট এবং ক্লিকথ্রু ব্যবহার করার জন্য div তৈরি করতে dai.html পরিবর্তন করুন। নিচের উদাহরণটি IMA DAI SDK ইমপোর্ট করে। আরও বিবরণের জন্য, IMA DAI SDK ইমপোর্ট করুন দেখুন।
এছাড়াও, dai.css
এবং dai.js ফাইল লোড করতে এবং hls.js ভিডিও প্লেয়ার ইমপোর্ট করতে প্রয়োজনীয় ট্যাগ যোগ করুন। তারপর,
পৃষ্ঠার এলিমেন্টের সাইজ ও পজিশন নির্দিষ্ট করতে dai.css পরিবর্তন করুন।
শেষে, dai.js-এ, স্ট্রিম অনুরোধের তথ্য ধরে রাখার জন্য ভেরিয়েবল, পৃষ্ঠা লোড হওয়ার সময় রান করার জন্য initPlayer() ফাংশন এবং ক্লিক করলে স্ট্রিমের অনুরোধ করার জন্য প্লে বোতাম সেট-আপ করুন।
পজ করা বিজ্ঞাপন বিরতির সময় প্লেব্যাক আবার চালু করতে, প্লেয়ার কন্ট্রোল দেখাতে ও লুকাতে ভিডিও এলিমেন্টের pause ও start ইভেন্টের জন্য ইভেন্ট লিসেনার সেট-আপ করুন।
IMA DAI SDK লোড করা
এরপর, dai.html-এ স্ক্রিপ্ট ট্যাগ ব্যবহার করে IMA ফ্রেমওয়ার্ক যোগ করুন, dai.js-এর জন্য ট্যাগের আগে।
StreamManager শুরু করুন
বিজ্ঞাপনের সেট অনুরোধ করতে, একটি ima.dai.api.StreamManager তৈরি করুন, যা
DAI স্ট্রিম অনুরোধ ও ম্যানেজ করার জন্য দায়ী। কনস্ট্রাক্টর বিজ্ঞাপনে ক্লিক ম্যানেজ করার জন্য একটি
ভিডিও এলিমেন্ট এবং একটি বিজ্ঞাপন UI এলিমেন্ট নেয়।
স্ট্রিম করার অনুরোধ করা
স্ট্রিমের অনুরোধ করার জন্য ফাংশন সংজ্ঞায়িত করুন। এই উদাহরণে VOD এবং লাইভ স্ট্রিম, দুটির জন্যই ফাংশন অন্তর্ভুক্ত আছে, যা VODStreamRequest
ক্লাস এবং LiveStreamRequest ক্লাসের ইনস্ট্যান্স তৈরি করে। আপনার streamRequest ইনস্ট্যান্স পাওয়ার পরে, স্ট্রিম অনুরোধ ইনস্ট্যান্সের সাথে
streamManager.requestStream() পদ্ধতি কল করুন।
দুটি স্ট্রিম অনুরোধ পদ্ধতিতেই একটি ঐচ্ছিক API key লাগে। আপনি যদি সুরক্ষিত স্ট্রিম ব্যবহার করেন, তাহলে আপনাকে DAI যাচাইকরণ কী তৈরি করতে হবে। আরও তথ্যের জন্য,
DAI ভিডিও স্ট্রিম সংক্রান্ত অনুরোধ যাচাই করা
দেখুন।
এই উদাহরণের কোনও স্ট্রিমই DAI যাচাইকরণ কী ব্যবহার করে সুরক্ষিত করা হয়নি, তাই
apiKey ব্যবহার করা হয়নি।
স্ট্রিম মেটাডেটা পার্স করুন
এছাড়াও, আপনাকে টাইমড মেটাডেটা ইভেন্ট শোনার জন্য একটি হ্যান্ডলার যোগ করতে হবে এবং
বিজ্ঞাপন বিরতির সময় IMA-এর জন্য বিজ্ঞাপন ইভেন্টগুলি নির্গত করতে StreamManager ক্লাসে ইভেন্টগুলি ফরওয়ার্ড করতে হবে:
এই নির্দেশিকা স্ট্রিম প্লেব্যাকের জন্য hls.js প্লেয়ার ব্যবহার করে, তবে আপনার মেটাডেটা
প্রয়োগ আপনি যে ধরনের প্লেয়ার ব্যবহার করেন তার উপর নির্ভর করে।
স্ট্রিম ইভেন্ট ম্যানেজ করা
প্রধান ভিডিও ইভেন্টের জন্য ইভেন্ট লিসনার প্রয়োগ করুন। এই উদাহরণটি onStreamEvent() ফাংশন কল করে
LOADED, ERROR, AD_BREAK_STARTED এবং AD_BREAK_ENDED ইভেন্ট
ম্যানেজ করে। এই ফাংশন স্ট্রিম লোড করা, স্ট্রিম সংক্রান্ত সমস্যা এবং বিজ্ঞাপন প্লেব্যাকের সময় প্লেয়ার কন্ট্রোল বন্ধ করার মতো বিষয়গুলি ম্যানেজ করে, যা IMA SDK-এর প্রয়োজন হয়।
স্ট্রিম লোড হয়ে গেলে, ভিডিও প্লেয়ার loadUrl() ফাংশন ব্যবহার করে
প্রদান করা URL লোড করে এবং চালায়।
ব্যস, এটুকুই যথেষ্ট! আপনি এখন IMA DAI SDK-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করছেন ও বিজ্ঞাপন দেখাচ্ছেন। আরও উন্নত SDK ফিচার সম্পর্কে জানতে, অন্যান্য নির্দেশিকা বা GitHub-এ স্যাম্পেল দেখুন।