DAI এর জন্য IMA SDK সেট আপ করুন, DAI এর জন্য IMA SDK সেট আপ করুন, DAI এর জন্য IMA SDK সেট আপ করুন, DAI এর জন্য IMA SDK সেট আপ করুন

প্ল্যাটফর্ম নির্বাচন করুন: HTML5 Android iOS tvOS Cast Roku

IMA SDK-এর মাধ্যমে আপনার ওয়েবসাইট এবং অ্যাপে মাল্টিমিডিয়া বিজ্ঞাপন যুক্ত করা সহজ। IMA SDK যেকোনো VAST-সম্মত অ্যাড সার্ভার থেকে বিজ্ঞাপনের জন্য অনুরোধ করতে পারে এবং আপনার অ্যাপে বিজ্ঞাপনের প্লেব্যাক পরিচালনা করতে পারে। IMA DAI SDK-এর সাহায্যে, অ্যাপগুলো বিজ্ঞাপন এবং কন্টেন্ট ভিডিও—উভয়ই VOD বা লাইভ কন্টেন্টের জন্য একটি স্ট্রিম অনুরোধ করে। এরপর SDK একটি সম্মিলিত ভিডিও স্ট্রিম ফেরত দেয়, ফলে আপনাকে আপনার অ্যাপের মধ্যে বিজ্ঞাপন এবং কন্টেন্ট ভিডিওর মধ্যে পরিবর্তন পরিচালনা করতে হয় না।

আপনার পছন্দের DAI সমাধানটি নির্বাচন করুন।

সম্পূর্ণ পরিষেবা সহ পড পরিবেশন

সম্পূর্ণ পরিষেবা DAI

এই নির্দেশিকাটি একটি সাধারণ ভিডিও প্লেয়ার অ্যাপে IMA DAI SDK কীভাবে ইন্টিগ্রেট করতে হয় তা দেখায়। আপনি যদি একটি সম্পূর্ণ নমুনা ইন্টিগ্রেশন দেখতে বা অনুসরণ করতে চান, তাহলে GitHub থেকে বেসিক উদাহরণটি ডাউনলোড করুন।

দ্রষ্টব্য: Roku-এর জন্য IMA DAI SDK, HLS এবং DASH উভয় স্ট্রিমকেই সমর্থন করে এবং এদের বাস্তবায়নে কোনো পার্থক্য নেই।

IMA DAI ব্যবহার করার জন্য, আপনার একটি Ad Manager 360 Advanced অ্যাকাউন্ট থাকতে হবে। যদি আপনার একটি Ad Manager অ্যাকাউন্ট থাকে, তবে আরও বিস্তারিত জানতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন। Ad Manager-এর জন্য সাইন আপ করার বিষয়ে তথ্যের জন্য, Ad Manager হেল্প সেন্টার দেখুন।

দ্রষ্টব্য: অন্যান্য প্ল্যাটফর্মের সাথে ইন্টিগ্রেশন বা IMA ক্লায়েন্ট-সাইড SDK ব্যবহারের তথ্যের জন্য, ইন্টারেক্টিভ মিডিয়া অ্যাডস SDK দেখুন।

আইএমএ ডিএআই ওভারভিউ

এই নির্দেশিকায় যেমন দেখানো হয়েছে, IMA DAI বাস্তবায়নে দুটি প্রধান SDK উপাদান জড়িত:

• StreamRequest : একটি অবজেক্ট যা একটি স্ট্রিম রিকোয়েস্টকে সংজ্ঞায়িত করে। স্ট্রিম রিকোয়েস্টগুলো ভিডিও-অন-ডিমান্ড অথবা লাইভ স্ট্রিমের জন্য হতে পারে। লাইভ স্ট্রিম রিকোয়েস্টে একটি অ্যাসেট কী নির্দিষ্ট করা থাকে, অন্যদিকে VOD রিকোয়েস্টে একটি CMS ID এবং ভিডিও ID নির্দিষ্ট করা থাকে। উভয় প্রকার রিকোয়েস্টেই ঐচ্ছিকভাবে নির্দিষ্ট স্ট্রিমগুলো অ্যাক্সেস করার জন্য প্রয়োজনীয় একটি API কী এবং Google Ad Manager সেটিংসে নির্দিষ্ট করা বিজ্ঞাপন শনাক্তকারীগুলো পরিচালনা করার জন্য IMA SDK-এর একটি Google Ad Manager নেটওয়ার্ক কোড অন্তর্ভুক্ত থাকতে পারে।
• StreamManager : একটি অবজেক্ট যা ডাইনামিক বিজ্ঞাপন সন্নিবেশ স্ট্রিম এবং DAI ব্যাকএন্ডের সাথে মিথস্ক্রিয়া পরিচালনা করে। স্ট্রিম ম্যানেজার ট্র্যাকিং পিংও পরিচালনা করে এবং স্ট্রিম ও বিজ্ঞাপন ইভেন্টগুলো পাবলিশারের কাছে ফরোয়ার্ড করে।

পূর্বশর্ত

• আপনার উদ্দিষ্ট ব্যবহারের ক্ষেত্রটি সমর্থিত কিনা তা নিশ্চিত করতে আমাদের সামঞ্জস্যতা পৃষ্ঠাটি ভালোভাবে পড়ুন।
• আমাদের Roku স্যাম্পল প্লেয়ার কোড ডাউনলোড করুন
• আপনার ডেভেলপমেন্ট সেটআপটি ঠিকমতো কাজ করছে কিনা তা যাচাই করতে নমুনা প্লেয়ার কোডটি একটি Roku ডিভাইসে স্থাপন করুন।

আপনার ভিডিও চালান

প্রদত্ত নমুনা ভিডিও প্লেয়ারটি কোনো অতিরিক্ত কনফিগারেশন ছাড়াই একটি কন্টেন্ট ভিডিও চালাতে পারে। আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট সঠিকভাবে সেট আপ করা হয়েছে কিনা তা নিশ্চিত করতে নমুনা প্লেয়ারটি আপনার Roku প্লেয়ারে স্থাপন করুন।

আপনার ভিডিও প্লেয়ারকে একটি IMA DAI স্ট্রিম প্লেয়ারে পরিণত করুন

একটি স্ট্রিম প্লেয়ার চালু করতে এই ধাপগুলো অনুসরণ করুন।

Sdk.xml তৈরি করুন

আপনার প্রজেক্টে MainScene.xml পাশে Sdk.xml নামে একটি নতুন ফাইল যোগ করুন এবং নিম্নলিখিত বয়লারপ্লেটটি যুক্ত করুন:

Sdk.xml

<?xml version = "1.0" encoding = "utf-8" ?>

<component name = "imasdk" extends = "Task">
<interface>
</interface>
<script type = "text/brightscript">
<![CDATA[
  ' Your code goes here.
]]>
</script>
</component>

এই নির্দেশিকা জুড়ে আপনাকে এই দুটি ফাইলই সম্পাদনা করতে হবে।

রোকু অ্যাডভার্টাইজিং ফ্রেমওয়ার্ক লোড করুন

IMA DAI SDK, Roku Advertising Framework-এর উপর নির্ভরশীল। ফ্রেমওয়ার্কটি লোড করতে, manifest এবং Sdk.xml এ নিম্নলিখিতটি যোগ করুন:

bs_libs_required=roku_ads_lib,googleima3
manifest

Library "Roku_Ads.brs"
Library "IMA3.brs"
Sdk.xml

IMA DAI SDK লোড করুন

IMA DAI SDK লোড করতে, নিম্নলিখিতগুলি করুন:

1. New_IMASDK() কল ব্যবহার করে IMA SDK চালু করুন:

   sub loadSdk()
     If m.sdk = invalid
       m.sdk = New_IMASDK()
     End If
     m.top.sdkLoaded = true
   End Sub
   Sdk.xml
   

2. একটি sdkLoaded বুলিয়ান ফিল্ড তৈরি করে IMA লোড হয়েছে কিনা তা ট্র্যাক করুন:

   <field id="sdkLoaded" type="Boolean" />
   Sdk.xml
   

3. প্রধান runThread() সাবরুটিন থেকে loadSdk() ) সাবরুটিনটি কল করুন:

   if not m.top.sdkLoaded
     loadSdk()
   End If
   Sdk.xml
   

4. sdkTask অবজেক্টটি তৈরি ও রান করার জন্য MainScene.xml এ loadImaSdk() ফাংশনটি তৈরি করুন:

   function loadImaSdk() as void
     m.sdkTask = createObject("roSGNode", "imasdk")
     m.sdkTask.observeField("sdkLoaded", "onSdkLoaded")
     m.sdkTask.observeField("errors", "onSdkLoadedError")
   
     ' Change to m.testLiveStream to demo live instead of VOD.
     selectedStream = m.testVodStream
     m.videoTitle = selectedStream.title
     m.sdkTask.streamData = selectedStream
   
     m.sdkTask.observeField("urlData", "urlLoadRequested")
     m.sdkTask.video = m.video
     ' Setting control to run starts the task thread.
     m.sdkTask.control = "RUN"
   end function
   MainScene.xml
   

5. init() ফাংশন থেকে loadImaSdk() ) ফাংশনটি কল করুন।

6. SDK লোড ইভেন্টগুলিতে সাড়া দেওয়ার জন্য onSdkLoaded() এবং onSdkLoadedError() লিসেনার সাবরুটিন তৈরি করুন:

   Sub onSdkLoaded(message as Object)
     print "----- onSdkLoaded --- control ";message
   End Sub
   
   Sub onSdkLoadedError(message as Object)
     print "----- errors in the sdk loading process --- ";message
   End Sub
   MainScene.xml
   

একটি IMA স্ট্রিম প্লেয়ার তৈরি করুন

একটি IMA স্ট্রিম প্লেয়ার তৈরি করতে, নিম্নলিখিতগুলি করুন:

1. একটি setupVideoPlayer() সাবরুটিন তৈরি করুন যা নিম্নলিখিত কাজগুলো করবে:

   1. স্ট্রিম প্লেয়ার তৈরি করতে createPlayer() মেথডটি ব্যবহার করুন।

   2. ওই স্ট্রিম প্লেয়ারটিতে loadUrl , adBreakStarted এবং adBreakEnded এই তিনটি কলব্যাক মেথড ইমপ্লিমেন্ট করুন।

   3. স্ট্রিম লোড হওয়ার সময় ট্রিক প্লে নিষ্ক্রিয় করুন, যাতে ব্যবহারকারীরা স্ট্রিম শুরু হওয়ার সাথে সাথেই, অর্থাৎ 'অ্যাড ব্রেক স্টার্টেড' ইভেন্টটি ফায়ার হওয়ার আগে, কোনো প্রি-রোল স্কিপ করতে না পারে।

   sub setupVideoPlayer()
     sdk = m.sdk
     m.player = sdk.createPlayer()
     m.player.top = m.top
     m.player.loadUrl = Function(urlData)
       ' This line prevents users from scanning during buffering
       ' or during the first second of the ad before we have a callback from roku.
       ' If there are no prerolls disabling trickplay isn't needed.
       m.top.video.enableTrickPlay = false
       m.top.urlData = urlData
     End Function
     m.player.adBreakStarted = Function(adBreakInfo as Object)
       print "---- Ad Break Started ---- "
       m.top.adPlaying = True
       m.top.video.enableTrickPlay = false
     End Function
     m.player.adBreakEnded = Function(adBreakInfo as Object)
       print "---- Ad Break Ended ---- "
       m.top.adPlaying = False
       m.top.video.enableTrickPlay = true
     End Function
     m.player.seek = Function(timeSeconds as Double)
       print "---- SDK requested seek to ----" ; timeSeconds
       m.top.video.seekMode = "accurate"
       m.top.video.seek = timeSeconds
     End Function
   End Sub
   Sdk.xml
   

   স্কিপেবল অ্যাড সাপোর্ট করার জন্য একটি seek কলব্যাক মেথড যোগ করুন। আরও বিস্তারিত জানতে, ‘স্কিপেবল অ্যাড সাপোর্ট যোগ করুন’ দেখুন।

2. setupVideoPlayer() সাবরুটিনে ব্যবহৃত urlData , adPlaying , এবং video ফিল্ডগুলো যোগ করুন:

   <field id="urlData" type="assocarray" />
   <field id="adPlaying" type="Boolean" />
   <field id="video" type="Node" />
   Sdk.xml
   

একটি স্ট্রিম অনুরোধ তৈরি এবং কার্যকর করুন

আপনার DAI স্ট্রিম অনুরোধ করতে, নিম্নলিখিতগুলি করুন:

1. একটি স্ট্রিম তৈরি ও অনুরোধ করার জন্য একটি loadStream() সাবরুটিন তৈরি করুন। `adChoices` আইকনের মতো বিজ্ঞাপনের UI সমর্থন করার জন্য, আপনার অনুরোধের অংশ হিসেবে অবশ্যই আপনার কন্টেন্ট ভিডিও ধারণকারী নোডের একটি রেফারেন্সও পাস করতে হবে।

   Sub loadStream()
     sdk = m.sdk
     sdk.initSdk()
     setupVideoPlayer()
   
     request = {}
     streamData = m.top.streamData
     if streamData.type = "live"
       request = sdk.CreateLiveStreamRequest(streamData.assetKey, streamData.apiKey, streamData.networkCode)
     else if streamData.type = "vod"
       request = sdk.CreateVodStreamRequest(streamData.contentSourceId, streamData.videoId, streamData.apiKey, streamData.networkCode)
     else
       request = sdk.CreateStreamRequest()
     end if
   
     request.player = m.player
     request.adUiNode = m.top.video
   
     requestResult = sdk.requestStream(request)
     If requestResult <> Invalid
       print "Error requesting stream ";requestResult
     Else
       m.streamManager = Invalid
       While m.streamManager = Invalid
         sleep(50)
         m.streamManager = sdk.getStreamManager()
       End While
       If m.streamManager = Invalid or m.streamManager["type"] <> Invalid or m.streamManager["type"] = "error"
         errors = CreateObject("roArray", 1, True)
         print "error ";m.streamManager["info"]
         errors.push(m.streamManager["info"])
         m.top.errors = errors
       Else
         m.top.streamManagerReady = True
         addCallbacks()
         m.streamManager.start()
       End If
     End If
   End Sub
   Sdk.xml
   

2. loadStream() সাবরুটিনে ব্যবহৃত streamData এবং streamManagerReady ফিল্ডগুলো যোগ করুন:

   <field id="streamManagerReady" type="Boolean" />
   <field id="streamData" type="assocarray" />
   Sdk.xml
   

3. যদি স্ট্রিম ম্যানেজার উপলব্ধ না থাকে, তাহলে runThread() সাবরুটিন থেকে loadStream() সাবরুটিনকে কল করুন:

   if not m.top.streamManagerReady
     loadStream()
   End If
   Sdk.xml
   

4. VOD অথবা লাইভস্ট্রিমের মধ্যে নির্বাচন করুন। নিম্নলিখিত উদাহরণটিতে একটি লাইভস্ট্রিম এবং একটি VOD স্ট্রিমের জন্য স্ট্রিম প্যারামিটার দেওয়া আছে:

   m.testLiveStream = {
     title: "Live Stream",
     assetKey: "c-rArva4ShKVIAkNfy6HUQ",
     networkCode: "21775744923",
     apiKey: "",
     type: "live"
   }
   m.testVodStream = {
     title: "VOD stream"
     contentSourceId: "2548831",
     videoId: "tears-of-steel",
     networkCode: "21775744923",
     apiKey: "",
     type: "vod"
   }
   MainScene.xml
   

   ডিফল্টরূপে, এই নির্দেশিকাটি VOD স্ট্রিম ব্যবহার করে। আপনি selectedStream ভেরিয়েবলটিকে m.testVodStream অবজেক্ট থেকে m.testLiveStream অবজেক্টে পরিবর্তন করে এর পরিবর্তে লাইভস্ট্রিম ব্যবহার করতে পারেন।

স্ট্রিম শুরু করুন

স্ট্রিম ডেটা শোনার জন্য urlLoadRequested() সাবরুটিন তৈরি করুন এবং playStream() সাবরুটিনকে কল করুন:

Sub urlLoadRequested(message as Object)
  print "Url Load Requested ";message
  data = message.getData()

  playStream(data.manifest, data.format)
End Sub
MainScene.xml

স্ট্রিম প্লেব্যাক শুরু করতে playStream() তৈরি করুন:

Sub playStream(url as String, format as String)
  vidContent = createObject("RoSGNode", "ContentNode")
  vidContent.url = url
  vidContent.title = m.videoTitle
  vidContent.streamformat = format
  m.video.content = vidContent
  m.video.setFocus(true)
  m.video.visible = true
  m.video.control = "play"
  m.video.EnableCookies()
End Sub
MainScene.xml

স্ট্রিম মেটাডেটার জন্য শুনুন

স্ট্রিম প্লেব্যাকের সময় চালানোর জন্য এবং StreamManager.onMessage() ব্যবহার করে IMA-তে স্ট্রিম মেটাডেটা পাঠানোর জন্য একটি while লুপ সহ runLoop() সাবরুটিন তৈরি করুন:

গুরুত্বপূর্ণ বিষয়: বিজ্ঞাপনের সঠিক প্রদর্শন নিশ্চিত করতে আপনাকে অবশ্যই সমস্ত বার্তা SDK-তে ফরোয়ার্ড করতে হবে।

Sub runLoop()
  ' Forward all timed metadata events.
  m.top.video.timedMetaDataSelectionKeys = ["*"]

  ' Cycle through all the fields and just listen to them all.
  m.port = CreateObject("roMessagePort")
  fields = m.top.video.getFields()
  for each field in fields
    m.top.video.observeField(field, m.port)
  end for

  while True
    msg = wait(1000, m.port)
    if m.top.video = invalid
      print "exiting"
      exit while
    end if

    m.streamManager.onMessage(msg)
    currentTime = m.top.video.position
    ' Only enable trickplay after a few seconds, in case we start with an ad,
    ' to prevent users from skipping through that ad.
    If currentTime > 3 And not m.top.adPlaying
       m.top.video.enableTrickPlay = true
    End If
  end while
End Sub
Sdk.xml

বিজ্ঞাপনের ঘটনাগুলো শুনুন

এখন যেহেতু আপনি IMA-তে স্ট্রিম মেটাডেটা পাঠাচ্ছেন, IMA বিজ্ঞাপনের বিরতির সময় অ্যাড ইভেন্ট নির্গত করতে পারে। অ্যাড ইভেন্টে সাড়া দেওয়ার জন্য প্রয়োজন অনুযায়ী অ্যাড ইভেন্ট লিসেনার তৈরি করুন:

Function addCallbacks() as Void
  m.streamManager.addEventListener(m.sdk.AdEvent.ERROR, errorCallback)
  m.streamManager.addEventListener(m.sdk.AdEvent.START, startCallback)
  m.streamManager.addEventListener(m.sdk.AdEvent.FIRST_QUARTILE, firstQuartileCallback)
  m.streamManager.addEventListener(m.sdk.AdEvent.MIDPOINT, midpointCallback)
  m.streamManager.addEventListener(m.sdk.AdEvent.THIRD_QUARTILE, thirdQuartileCallback)
  m.streamManager.addEventListener(m.sdk.AdEvent.COMPLETE, completeCallback)
End Function

Function startCallback(ad as Object) as Void
  print "Callback from SDK -- Start called - "
End Function

Function firstQuartileCallback(ad as Object) as Void
  print "Callback from SDK -- First quartile called - "
End Function

Function midpointCallback(ad as Object) as Void
  print "Callback from SDK -- Midpoint called - "
End Function

Function thirdQuartileCallback(ad as Object) as Void
  print "Callback from SDK -- Third quartile called - "
End Function

Function completeCallback(ad as Object) as Void
  print "Callback from SDK -- Complete called - "
End Function

Function errorCallback(error as Object) as Void
  print "Callback from SDK -- Error called - "; error
  ' errors are critical and should terminate the stream.
  m.errorState = True
End Function
Sdk.xml

স্কিপযোগ্য বিজ্ঞাপনের জন্য সমর্থন যোগ করুন (ঐচ্ছিক)

স্কিপযোগ্য বিজ্ঞাপন সমর্থন করার জন্য, আপনাকে IMA DAI SDK-এর প্লেয়ার অবজেক্টে একটি seek মেথড যোগ করতে হবে, যা প্রোগ্রাম্যাটিকভাবে ভিডিওটিকে ফ্লোটিং-পয়েন্ট সেকেন্ডে নির্দিষ্ট অবস্থানে নিয়ে যায়।

স্কিপযোগ্য বিজ্ঞাপন সমর্থন করার জন্য, আপনাকে অবশ্যই আপনার অনুরোধে adUiNode সেট করতে হবে।

m.player.seek = Function(timeSeconds as Double)
  print "---- SDK requested seek to ----" ; timeSeconds
  m.top.video.seekMode = "accurate"
  m.top.video.seek = timeSeconds
End Function
Sdk.xml