ExoPlayer IMA এক্সটেনশন দিয়ে শুরু করুন

ExoPlayer হল একটি অ্যান্ড্রয়েড মিডিয়া প্লেয়ার। এই নির্দেশিকাটি আপনাকে ExoPlayer IMA এক্সটেনশনটি কীভাবে ব্যবহার করবেন তা দেখায়। এই এক্সটেনশনটি বিজ্ঞাপন এবং কন্টেন্ট উভয়ের সাথে মিডিয়া স্ট্রিম অনুরোধ এবং প্লে করতে IMA DAI SDK ব্যবহার করে।

নিম্নলিখিত এক্সটেনশনের সুবিধাগুলি তালিকাভুক্ত করা হয়েছে:

• IMA বৈশিষ্ট্যগুলিকে একীভূত করার জন্য প্রয়োজনীয় কোডকে সরলীকৃত করে।
• নতুন IMA সংস্করণে আপডেট করার জন্য প্রয়োজনীয় সময় কমিয়ে দেয়।

ExoPlayer IMA এক্সটেনশনটি HLS এবং DASH স্ট্রিমিং প্রোটোকল সমর্থন করে। এখানে একটি সারসংক্ষেপ দেওয়া হল:

এক্সোপ্লেয়ার-আইএমএ এক্সটেনশন স্ট্রিম সাপোর্ট
	সরাসরি সম্প্রচার	ভিওডি স্ট্রিম
এইচএলএস
ড্যাশ

ExoPlayer-IMA সংস্করণ 1.1.0 এবং পরবর্তী সংস্করণগুলি DASH লাইভ স্ট্রিম সমর্থন করে।

এই নির্দেশিকাটি ExoPlayer নির্দেশিকা ব্যবহার করে আপনাকে একটি সম্পূর্ণ অ্যাপ তৈরি করতে এবং এক্সটেনশনটি সংহত করতে সাহায্য করবে। একটি সম্পূর্ণ নমুনা অ্যাপের জন্য, GitHub-এ ExoPlayerExample দেখুন।

মূল বিষয়: ExoPlayer IMA এক্সটেনশনের জন্য ExoPlayer প্রয়োজন। যদি আপনি অন্য প্লেয়ার পছন্দ করেন, তাহলে আপনার অ্যাপে IMA DAI SDK ইন্টিগ্রেট করতে "শুরু করুন" নির্দেশিকা অনুসরণ করুন।

পূর্বশর্ত

• অ্যান্ড্রয়েড স্টুডিও
• DAI সাপোর্টের জন্য AndroidX Media3 ExoPlayer ভার্সন 1.0.0 বা তার পরবর্তী।

একটি নতুন অ্যান্ড্রয়েড স্টুডিও প্রকল্প তৈরি করুন

আপনার অ্যান্ড্রয়েড স্টুডিও প্রকল্প তৈরি করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

1. অ্যান্ড্রয়েড স্টুডিও শুরু করুন।
2. একটি নতুন অ্যান্ড্রয়েড স্টুডিও প্রকল্প শুরু করুন নির্বাচন করুন।
3. আপনার প্রকল্প নির্বাচন করুন পৃষ্ঠায়, কোনও কার্যকলাপ নেই টেমপ্লেট নির্বাচন করুন।
4. পরবর্তী ক্লিক করুন।
5. "আপনার প্রকল্প কনফিগার করুন" পৃষ্ঠায়, আপনার প্রকল্পের নাম দিন এবং ভাষা হিসেবে জাভা নির্বাচন করুন। দ্রষ্টব্য: IMA DAI SDK কোটলিনের সাথে কাজ করে, তবে এই নির্দেশিকাটি জাভা উদাহরণ ব্যবহার করে।

• Finish এ ক্লিক করুন।

আপনার প্রোজেক্টে ExoPlayer IMA এক্সটেনশন যোগ করুন।

ExoPlayer IMA এক্সটেনশন যোগ করতে, নিম্নলিখিতগুলি করুন:

1. আপনার অ্যাপের build.gradle ফাইলের dependencies বিভাগে নিম্নলিখিত আমদানিগুলি অন্তর্ভুক্ত করুন:

   dependencies {
       def media3_version = "1.8.0"
       implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
       implementation 'androidx.appcompat:appcompat:1.7.1'
       implementation "androidx.media3:media3-ui:$media3_version"
       implementation "androidx.media3:media3-exoplayer:$media3_version"
       implementation "androidx.media3:media3-exoplayer-hls:$media3_version"
       implementation "androidx.media3:media3-exoplayer-dash:$media3_version"
   
       // The library adds the IMA ExoPlayer integration for ads.
       implementation "androidx.media3:media3-exoplayer-ima:$media3_version"
   }
   build.gradle
   

2. বিজ্ঞাপনের অনুরোধ করার জন্য IMA DAI SDK-এর প্রয়োজনীয় ব্যবহারকারীর অনুমতি যোগ করুন:

   <uses-permission android:name="android.permission.INTERNET"/>
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
   AndroidManifest.xml
   

ExoPlayer UI সেট আপ করুন

ExoPlayer UI সেট আপ করতে, নিম্নলিখিতগুলি করুন:

1. ExoPlayer এর জন্য PlayerView অবজেক্ট তৈরি করুন।

2. ExoPlayer IMA এক্সটেনশনের সুপারিশ অনুযায়ী, androidx.constraintlayout.widget.ConstraintLayout ভিউটিকে LinearLayout ভিউতে পরিবর্তন করুন:

   <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:tools="http://schemas.android.com/tools"
       android:id="@+id/container"
       android:layout_width="match_parent"
       android:layout_height="match_parent"
       android:orientation="vertical"
       tools:context=".MyActivity"
       tools:ignore="MergeRootFrame">
   
       <androidx.media3.ui.PlayerView
           android:id="@+id/player_view"
           android:fitsSystemWindows="true"
           android:layout_width="match_parent"
           android:layout_height="wrap_content" />
   
       <!-- UI element for viewing SDK event log -->
       <TextView
           android:id="@+id/logText"
           android:gravity="bottom"
           android:layout_width="match_parent"
           android:layout_height="wrap_content"
           android:maxLines="100"
           android:scrollbars="vertical"
           android:textSize="@dimen/font_size">
       </TextView>
   
   </LinearLayout>
   activity_my.xml
   

আপনার স্ট্রিম প্যারামিটার যোগ করুন

আপনার প্রোজেক্ট পরীক্ষা করার জন্য নমুনা স্ট্রিম সম্পদের জন্য IMA নমুনা স্ট্রিম পৃষ্ঠাটি দেখুন। আপনার নিজস্ব স্ট্রিম সেট আপ করতে, DAI-তে বিজ্ঞাপন পরিচালক বিভাগটি দেখুন।

এই ধাপটি একটি লাইভস্ট্রিম সেট আপ করে। ExoPlayer IMA এক্সটেনশনটি DAI VOD স্ট্রিমগুলিকেও সমর্থন করে। VOD স্ট্রিমগুলির জন্য আপনার অ্যাপের কী পরিবর্তন প্রয়োজন তা জানতে, ভিডিও অন ডিমান্ড (VOD) স্ট্রিমগুলির জন্য ধাপটি দেখুন।

ExoPlayer IMA এক্সটেনশনটি আমদানি করুন

1. ExoPlayer এক্সটেনশনের জন্য নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:

   import static androidx.media3.common.C.CONTENT_TYPE_HLS;
   
   import android.annotation.SuppressLint;
   import android.app.Activity;
   import android.net.Uri;
   import android.os.Bundle;
   import android.text.method.ScrollingMovementMethod;
   import android.util.Log;
   import android.widget.TextView;
   import androidx.media3.common.MediaItem;
   import androidx.media3.common.util.Util;
   import androidx.media3.datasource.DataSource;
   import androidx.media3.datasource.DefaultDataSource;
   import androidx.media3.exoplayer.ExoPlayer;
   import androidx.media3.exoplayer.ima.ImaServerSideAdInsertionMediaSource;
   import androidx.media3.exoplayer.ima.ImaServerSideAdInsertionUriBuilder;
   import androidx.media3.exoplayer.source.DefaultMediaSourceFactory;
   import androidx.media3.ui.PlayerView;
   import com.google.ads.interactivemedia.v3.api.AdEvent;
   import com.google.ads.interactivemedia.v3.api.ImaSdkFactory;
   import com.google.ads.interactivemedia.v3.api.ImaSdkSettings;
   import java.util.HashMap;
   import java.util.Map;
   MyActivity.java
   

2. MyActivity.java তে, এই ব্যক্তিগত ভেরিয়েবলগুলি যোগ করুন:

   • PlayerView
   • ExoPlayer
   • ImaServerSideAdInsertionMediaSource.AdsLoader
   • ImaServerSideAdInsertionMediaSource.AdsLoader.State

   বিগ বাক বানি (লাইভ) এইচএলএস স্ট্রিম দিয়ে পরীক্ষা করতে, এর অ্যাসেট কী যোগ করুন। আপনি আইএমএর নমুনা স্ট্রিম পৃষ্ঠায় পরীক্ষা করার জন্য আরও স্ট্রিম খুঁজে পেতে পারেন।

3. AdsLoader অবস্থা সংরক্ষণ এবং পুনরুদ্ধার করতে একটি KEY_ADS_LOADER_STATE ধ্রুবক তৈরি করুন:

   /** Main Activity. */
   @SuppressLint("UnsafeOptInUsageError")
   /* @SuppressLint is needed for new media3 APIs. */
   public class MyActivity extends Activity {
   
     private static final String KEY_ADS_LOADER_STATE = "ads_loader_state";
     private static final String SAMPLE_ASSET_KEY = "c-rArva4ShKVIAkNfy6HUQ";
     private static final String LOG_TAG = "ImaExoPlayerExample";
   
     private PlayerView playerView;
     private TextView logText;
     private ExoPlayer player;
     private ImaServerSideAdInsertionMediaSource.AdsLoader adsLoader;
     private ImaServerSideAdInsertionMediaSource.AdsLoader.State adsLoaderState;
     private ImaSdkSettings imaSdkSettings;
   MyActivity.java
   

একটি adsLoader ইনস্ট্যান্স তৈরি করুন

onCreate পদ্ধতিটি ওভাররাইড করুন। এতে, PlayerView খুঁজুন এবং একটি সংরক্ষিত AdsLoader.State আছে কিনা তা পরীক্ষা করুন। adsLoader অবজেক্টটি শুরু করার সময় আপনি এই অবস্থাটি ব্যবহার করতে পারেন।

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_my);

  // Initialize the IMA SDK as early as possible when the app starts. If your app already
  // overrides Application.onCreate(), call this method inside the onCreate() method.
  // https://developer.android.com/topic/performance/vitals/launch-time#app-creation
  ImaSdkFactory.getInstance().initialize(this, getImaSdkSettings());

  playerView = findViewById(R.id.player_view);

  // Checks if there is a saved AdsLoader state to be used later when initiating the AdsLoader.
  if (savedInstanceState != null) {
    Bundle adsLoaderStateBundle = savedInstanceState.getBundle(KEY_ADS_LOADER_STATE);
    if (adsLoaderStateBundle != null) {
      adsLoaderState =
          ImaServerSideAdInsertionMediaSource.AdsLoader.State.fromBundle(adsLoaderStateBundle);
    }
  }
}

private ImaSdkSettings getImaSdkSettings() {
  if (imaSdkSettings == null) {
    imaSdkSettings = ImaSdkFactory.getInstance().createImaSdkSettings();
    // Set any IMA SDK settings here.
  }
  return imaSdkSettings;
}
MyActivity.java

গুরুত্বপূর্ণ: IMA লোড টাইম উন্নত করতে, অ্যাপ লাইফসাইকেলে যত তাড়াতাড়ি সম্ভব ImaSdkFactory.initialize() পদ্ধতিটি কল করুন। পদ্ধতিটি আগে কল করলে IMA-এর প্রথম স্ট্রিম অনুরোধের আগে প্রয়োজনীয় রিসোর্স লোড করার সময় সর্বাধিক হয়। ImaSdkFactory.initialize() পদ্ধতি কল একটি ImaSdkSettings ইনস্ট্যান্স গ্রহণ করে। এখানে এবং যখন আপনি একটি AdsLoader ইনস্ট্যান্স তৈরি করেন তখন একই সেটিংস মান ব্যবহার করতে ভুলবেন না। এই উদাহরণে সেটিংস মান একই থাকে তা নিশ্চিত করার জন্য getImaSdkSettings() সহায়ক পদ্ধতি ব্যবহার করা হয়েছে। আরও তথ্যের জন্য, Optimize IMA লোড টাইম গাইড> দেখুন।

প্লেয়ারটি আরম্ভ করার জন্য পদ্ধতি যোগ করুন

প্লেয়ারটি আরম্ভ করার জন্য একটি পদ্ধতি যোগ করুন। এই পদ্ধতিতে নিম্নলিখিতগুলি করতে হবে:

• একটি AdsLoader ইনস্ট্যান্স তৈরি করুন।
• ExoPlayer তৈরি করুন।
• লাইভ স্ট্রিমের অ্যাসেট কী ব্যবহার করে একটি MediaItem তৈরি করুন।
• আপনার প্লেয়ারের জন্য MediaItem সেট করুন।

// Create a server side ad insertion (SSAI) AdsLoader.
private ImaServerSideAdInsertionMediaSource.AdsLoader createAdsLoader() {
  ImaServerSideAdInsertionMediaSource.AdsLoader.Builder adsLoaderBuilder =
      new ImaServerSideAdInsertionMediaSource.AdsLoader.Builder(this, playerView);

  // Attempts to set the AdsLoader state if available from a previous session.
  if (adsLoaderState != null) {
    adsLoaderBuilder.setAdsLoaderState(adsLoaderState);
  }

  return adsLoaderBuilder
      .setAdEventListener(buildAdEventListener())
      .setImaSdkSettings(getImaSdkSettings())
      .build();
}

private void initializePlayer() {
  adsLoader = createAdsLoader();

  // Set up the factory for media sources, passing the ads loader.
  DataSource.Factory dataSourceFactory = new DefaultDataSource.Factory(this);

  DefaultMediaSourceFactory mediaSourceFactory = new DefaultMediaSourceFactory(dataSourceFactory);

  // MediaSource.Factory to create the ad sources for the current player.
  ImaServerSideAdInsertionMediaSource.Factory adsMediaSourceFactory =
      new ImaServerSideAdInsertionMediaSource.Factory(adsLoader, mediaSourceFactory);

  // 'mediaSourceFactory' is an ExoPlayer component for the DefaultMediaSourceFactory.
  // 'adsMediaSourceFactory' is an ExoPlayer component for a MediaSource factory for IMA server
  // side inserted ad streams.
  mediaSourceFactory.setServerSideAdInsertionMediaSourceFactory(adsMediaSourceFactory);

  // Create a SimpleExoPlayer and set it as the player for content and ads.
  player = new ExoPlayer.Builder(this).setMediaSourceFactory(mediaSourceFactory).build();
  playerView.setPlayer(player);
  adsLoader.setPlayer(player);

  // Create the MediaItem to play, specifying the stream URI.
  Uri ssaiUri = buildLiveStreamUri(SAMPLE_ASSET_KEY, CONTENT_TYPE_HLS);
  MediaItem ssaiMediaItem = MediaItem.fromUri(ssaiUri);

  // Prepare the content and ad to be played with the ExoPlayer.
  player.setMediaItem(ssaiMediaItem);
  player.prepare();

  // Set PlayWhenReady. If true, content and ads will autoplay.
  player.setPlayWhenReady(false);
}

/**
 * Builds an IMA SSAI live stream URI for the given asset key and format.
 *
 * @param assetKey The asset key of the live stream.
 * @param format The format of the live stream request, either {@code CONTENT_TYPE_HLS} or {@code
 *     CONTENT_TYPE_DASH}.
 * @return The URI of the live stream.
 */
public Uri buildLiveStreamUri(String assetKey, int format) {
  Map<String, String> adTagParams = new HashMap<String, String>();
  // Update the adTagParams map with any parameters.
  // For more information, see https://support.google.com/admanager/answer/7320899

  return new ImaServerSideAdInsertionUriBuilder()
      .setAssetKey(assetKey)
      .setFormat(format)
      .setAdTagParameters(adTagParams)
      .build();
}
MyActivity.java

দ্রষ্টব্য: এই বিভাগটি সার্ভার-সাইড বিজ্ঞাপন সন্নিবেশ (SSAI) ধারণার নাম সহ পদ্ধতি ব্যবহার করে।

• গুগল অ্যাড ম্যানেজার ডিএআই হল এসএসএআই-এর একটি উদাহরণ।
• এই গাইডের ExoPlayer IMA এক্সটেনশনটি বিশেষভাবে Ad Manager DAI-এর সাথে কাজ করে। ExoPlayer IMA এক্সটেনশনটি বিভিন্ন SSAI সমাধানও সমর্থন করে।

প্লেয়ারটি ছেড়ে দেওয়ার জন্য একটি পদ্ধতি যোগ করুন

প্লেয়ারটি রিলিজ করার জন্য একটি পদ্ধতি যোগ করুন। এই পদ্ধতিতে নিম্নলিখিত ক্রিয়াগুলি ক্রমানুসারে সম্পাদন করতে হবে:

• প্লেয়ারের রেফারেন্সগুলিকে null এ সেট করুন এবং প্লেয়ারের রিসোর্সগুলি ছেড়ে দিন।
• adsLoader অবস্থা প্রকাশ করুন।

private void releasePlayer() {
  // Set the player references to null and release the player's resources.
  playerView.setPlayer(null);
  player.release();
  player = null;

  // Release the adsLoader state so that it can be initiated again.
  adsLoaderState = adsLoader.release();
}
MyActivity.java

প্লেয়ার ইভেন্ট পরিচালনা করুন

প্লেয়ার ইভেন্ট পরিচালনা করতে, স্ট্রিম প্লেব্যাক পরিচালনা করার জন্য অ্যাক্টিভিটির জীবনচক্র ইভেন্টগুলির জন্য কলব্যাক তৈরি করুন।

অ্যান্ড্রয়েড এপিআই লেভেল ২৪ এবং তার পরবর্তী সংস্করণের জন্য, নিম্নলিখিত পদ্ধতিগুলি ব্যবহার করুন:

• onStart()
• onStop()

২৪ বছরের আগের Android API লেভেলের জন্য, নিম্নলিখিত পদ্ধতিগুলি ব্যবহার করুন:

• onResume()
• onPause()

onStart() এবং onResume() পদ্ধতিগুলি playerView.onResume() তে ম্যাপ করে, যখন onStop() এবং onPause() playerView.onPause() তে ম্যাপ করে।

মূল বিষয়: এই উদাহরণটি Android SDK সংস্করণ 24+ এবং তার আগের সংস্করণগুলিকে সমর্থন করে। Android SDK সংস্করণ 24+ এর জন্য onStart() / onStop() এবং 24 এর আগের সংস্করণগুলির জন্য onResume() / onPause() ব্যবহার করুন।

এই ধাপটি adsLoaderState সংরক্ষণের জন্য onSaveInstanceState() ইভেন্টটিও ব্যবহার করে।

@Override
public void onStart() {
  super.onStart();
  if (Util.SDK_INT > 23) {
    initializePlayer();
    if (playerView != null) {
      playerView.onResume();
    }
  }
}

@Override
public void onResume() {
  super.onResume();
  if (Util.SDK_INT <= 23 || player == null) {
    initializePlayer();
    if (playerView != null) {
      playerView.onResume();
    }
  }
}

@Override
public void onPause() {
  super.onPause();
  if (Util.SDK_INT <= 23) {
    if (playerView != null) {
      playerView.onPause();
    }
    releasePlayer();
  }
}

@Override
public void onStop() {
  super.onStop();
  if (Util.SDK_INT > 23) {
    if (playerView != null) {
      playerView.onPause();
    }
    releasePlayer();
  }
}

@Override
public void onSaveInstanceState(Bundle outState) {
  // Attempts to save the AdsLoader state to handle app backgrounding.
  if (adsLoaderState != null) {
    outState.putBundle(KEY_ADS_LOADER_STATE, adsLoaderState.toBundle());
  }
}
MyActivity.java

ভিওডি স্ট্রিম সেটআপ (ঐচ্ছিক)

যদি আপনার অ্যাপের বিজ্ঞাপন সহ VOD কন্টেন্ট চালানোর প্রয়োজন হয়, তাহলে এই পদক্ষেপগুলি অনুসরণ করুন:

1. একটি VOD স্ট্রিমের জন্য একটি CMS ID এবং Video ID যোগ করুন। পরীক্ষার জন্য, এই স্ট্রিম প্যারামিটারগুলি ব্যবহার করুন:
   • সিএমএস আইডি : "2548831"
   • ভিডিও আইডি : "tears-of-steel"

2. ImaServerSideAdInsertionUriBuilder() পদ্ধতি ব্যবহার করে একটি SSAI VOD URI তৈরি করুন:

   /**
    * Builds an IMA SSAI VOD stream URI for the given CMS ID, video ID, and format.
    *
    * @param cmsId The CMS ID of the VOD stream.
    * @param videoId The video ID of the VOD stream.
    * @param format The format of the VOD stream request, either {@code CONTENT_TYPE_HLS} or {@code
    *     CONTENT_TYPE_DASH}.
    * @return The URI of the VOD stream.
    */
   public Uri buildVodStreamUri(String cmsId, String videoId, int format) {
     Map<String, String> adTagParams = new HashMap<String, String>();
     // Update the adTagParams map with any parameters.
     // For more information, see https://support.google.com/admanager/answer/7320899
   
     return new ImaServerSideAdInsertionUriBuilder()
         .setContentSourceId(cmsId)
         .setVideoId(videoId)
         .setFormat(format)
         .setAdTagParameters(adTagParams)
         .build();
   }
   MyActivity.java
   

3. MediaItem.fromUri() পদ্ধতি ব্যবহার করে আপনার প্লেয়ারের মিডিয়া আইটেম হিসেবে নতুন VOD স্ট্রিম URI সেট করুন।

সফল হলে, আপনি ExoPlayer IMA এক্সটেনশনের সাহায্যে একটি মিডিয়া স্ট্রিম অনুরোধ করতে এবং চালাতে পারেন। সম্পূর্ণ উদাহরণের জন্য, GitHub-এ Android DAI নমুনা দেখুন।