এই নির্দেশিকা থেকে জানতে পারবেন যে কীভাবে ভিডিও প্লেয়ার অ্যাপে 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 ভিডিও এলিমেন্ট তৈরি করতে dai.html পরিবর্তন করুন এবং ক্লিকথ্রু ব্যবহার করার জন্য একটি div তৈরি করুন। নিচের উদাহরণটি IMA DAI SDK ইমপোর্ট করে। আরও বিবরণের জন্য, IMA DAI SDK ইমপোর্ট করুন দেখুন।
এছাড়াও, dai.css
এবং dai.js ফাইল লোড করতে এবং hls.js ভিডিও প্লেয়ার ইমপোর্ট করতে প্রয়োজনীয় ট্যাগ যোগ করুন। তারপর,
পৃষ্ঠা উপাদানের সাইজ ও অবস্থান নির্দিষ্ট করতে dai.css পরিবর্তন করুন।
সবশেষে, dai.js-এ, স্ট্রিম অনুরোধের তথ্য ধরে রাখার জন্য ভেরিয়েবল, পৃষ্ঠা লোড হওয়ার সময় চালানোর জন্য একটি initPlayer() ফাংশন এবং ক্লিক করার সময় স্ট্রিমের অনুরোধ করার জন্য প্লে বোতাম সেট-আপ করুন।
পজ করা বিজ্ঞাপন বিরতির সময় প্লেব্যাক আবার চালু করতে, প্লেয়ার কন্ট্রোল দেখাতে ও লুকাতে ভিডিও এলিমেন্টের pause ও start ইভেন্টের জন্য ইভেন্ট লিসেনার সেট-আপ করুন।
IMA DAI SDK লোড করুন
এরপর, dai.js-এর ট্যাগের আগে dai.html-এ স্ক্রিপ্ট ট্যাগ ব্যবহার করে IMA ফ্রেমওয়ার্ক যোগ করুন।
StreamManager শুরু করুন
বিজ্ঞাপনের সেট অনুরোধ করতে, একটি ima.dai.api.StreamManager তৈরি করুন, যা
DAI স্ট্রিম অনুরোধ ও ম্যানেজ করার জন্য দায়ী। কনস্ট্রাক্টর, বিজ্ঞাপনে ক্লিক ম্যানেজ করার জন্য
ভিডিও এলিমেন্ট এবং বিজ্ঞাপন UI এলিমেন্ট নেয়।
স্ট্রিম করার অনুরোধ করা
স্ট্রিমের অনুরোধ করার জন্য ফাংশন সংজ্ঞায়িত করুন। এই উদাহরণে VOD ও লাইভ স্ট্রিম, দুটির জন্যই ফাংশন অন্তর্ভুক্ত আছে, যা VODStreamRequest
ক্লাস ও LiveStreamRequest ক্লাসের ইনস্ট্যান্স তৈরি করে। আপনার streamRequest ইনস্ট্যান্স পাওয়ার পরে, স্ট্রিম অনুরোধ ইনস্ট্যান্সের সাথে
streamManager.requestStream() মেথড কল করুন।
দুটি স্ট্রিম অনুরোধ পদ্ধতিতেই একটি ঐচ্ছিক API কী লাগে। আপনি সুরক্ষিত স্ট্রিম ব্যবহার করলে, আপনাকে 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-এ স্যাম্পেল দেখুন।