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

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

এখানে এক্সটেনশনের কিছু সুবিধা রয়েছে:

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

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

ExoPlayer-IMA এক্সটেনশন স্ট্রিম সমর্থন
সরাসরি সম্প্রচার ভিওডি স্ট্রীম
এইচএলএস CheckmarkCheckmark
ড্যাশ CheckmarkCheckmark

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

এই নির্দেশিকাটি ExoPlayer গাইডের উপর ভিত্তি করে তৈরি করা হয়েছে এবং কীভাবে একটি সম্পূর্ণ অ্যাপ তৈরি করতে হবে এবং এক্সটেনশনটি সংহত করতে হবে তা দেখায়। একটি সম্পূর্ণ নমুনা অ্যাপ্লিকেশন সহ একটি উদাহরণের জন্য GitHub থেকে ExoPlayerExample দেখুন।

পূর্বশর্ত

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

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

  • অ্যান্ড্রয়েড স্টুডিও শুরু করুন।
  • একটি নতুন অ্যান্ড্রয়েড স্টুডিও প্রকল্প শুরু করুন নির্বাচন করুন।
  • আপনার প্রকল্প চয়ন করুন পৃষ্ঠায়, কোনো কার্যকলাপ নেই টেমপ্লেট নির্বাচন করুন।
  • পরবর্তী ক্লিক করুন.

  • আপনার প্রকল্প কনফিগার করুন পৃষ্ঠায়, আপনার প্রকল্পের নাম দিন এবং ভাষার জন্য Java নির্বাচন করুন।

  • শেষ ক্লিক করুন.

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

dependencies বিভাগে অ্যাপ্লিকেশন-স্তরের build.gradle ফাইলে এক্সটেনশনের জন্য আমদানি যোগ করুন।

আপনার অ্যাপ কনফিগার করুন এবং মাল্টিডেক্স সক্ষম করুন। এক্সটেনশনের আকারের কারণে এটি প্রয়োজনীয়, এবং Android 4.4W (API স্তর 20) বা তার নিচে সেট করা minSdkVersion সহ অ্যাপগুলির জন্য এটি প্রয়োজনীয়৷

এখানে একটি উদাহরণ:

app/build.gradle

android {

  ...

  defaultConfig {
      applicationId "com.google.ads.interactivemedia.v3.samples.videoplayerapp"
      minSdkVersion 19
      targetSdkVersion 34
      multiDexEnabled true
      versionCode 1
      versionName "1.0"
  }

    ...
}
dependencies {
    implementation 'androidx.multidex:multidex:2.0.1'
    implementation 'androidx.media3:media3-ui:1.1.1'
    implementation 'androidx.media3:media3-exoplayer:1.1.1'
    implementation 'androidx.media3:media3-exoplayer-hls:1.1.1'
    implementation 'androidx.media3:media3-exoplayer-dash:1.1.1'

    // Adding the ExoPlayer IMA extension for ads will also include the IMA
    // SDK as a dependency.
    implementation 'androidx.media3:media3-exoplayer-ima:1.1.1'
}

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

app/src/main/AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.project name">

    <!-- Required permissions for the IMA SDK -->
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

    ...

</manifest>

অভিপ্রায় ঘোষণা যোগ করুন

যদি আপনার অ্যাপটি Android 11 (API লেভেল 30) বা উচ্চতরকে টার্গেট করে, তাহলে IMA SDK-এর বর্তমান এবং সাম্প্রতিক সংস্করণগুলির জন্য ওয়েব লিঙ্কগুলি খোলার অভিপ্রায়ের একটি সুস্পষ্ট ঘোষণার প্রয়োজন। বিজ্ঞাপন ক্লিকথ্রু সক্ষম করার জন্য আপনার অ্যাপের ম্যানিফেস্ট ফাইলে নিম্নলিখিত স্নিপেট যোগ করুন (যারা আরও জানুন বোতামে ক্লিক করছেন)।

  <?xml version="1.0" encoding="utf-8"?>
  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.example.project name">

      ...

    </application>

    <queries>
      <intent>
          <action android:name="android.intent.action.VIEW" />
          <data android:scheme="https" />
      </intent>
      <intent>
          <action android:name="android.intent.action.VIEW" />
          <data android:scheme="http" />
      </intent>
    </queries>
  </manifest>

ExoPlayer এর UI সেট আপ করুন

ExoPlayer ব্যবহার করার জন্য PlayerView অবজেক্ট তৈরি করুন।

androidx.constraintlayout.widget.ConstraintLayout একটি LinearLayout এ পরিবর্তন করুন, যা ExoPlayer IMA এক্সটেনশনের জন্য সুপারিশ করা হয়।

এখানে একটি উদাহরণ:

app/src/main/res/layout/activity_my.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:background="@android:color/black"
    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:layout_width="match_parent"
        android:layout_height="match_parent" />

</LinearLayout>

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

আপনার প্রকল্প পরীক্ষা করার জন্য নমুনা স্ট্রিম সম্পদের জন্য IMA নমুনা স্ট্রিম পৃষ্ঠা দেখুন। এছাড়াও আপনার নিজস্ব স্ট্রীম সেট আপ করার তথ্যের জন্য DAI-তে অ্যাড ম্যানেজার বিভাগটি দেখুন।

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

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

ExoPlayer এক্সটেনশনের জন্য আমদানি বিবৃতি যোগ করুন।

MyActivity.java তে নিম্নলিখিত ব্যক্তিগত ভেরিয়েবল যোগ করুন:

এই স্ট্রীমের সাথে পরীক্ষা করতে বিগ বক বানি (লাইভ) HLS স্ট্রীমের সম্পদ কী যোগ করুন। IMA-এর নমুনা স্ট্রিম পৃষ্ঠায় পরীক্ষা করার জন্য আরও স্ট্রীম উপলব্ধ।

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

এখানে একটি উদাহরণ:

app/src/main/java/com/example/ project name /MyActivity.java


import static androidx.media3.common.C.CONTENT_TYPE_HLS;

import android.app.Activity;
import android.net.Uri;
import android.os.Bundle;
import androidx.annotation.Nullable;
import androidx.annotation.OptIn;
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.exoplayer.util.EventLogger;
import androidx.media3.ui.PlayerView;
import androidx.multidex.MultiDex;

...

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 PlayerView playerView;
  private ExoPlayer player;
  private ImaServerSideAdInsertionMediaSource.AdsLoader adsLoader;
  private ImaServerSideAdInsertionMediaSource.AdsLoader.State adsLoaderState;

}

একটি adsLoader উদাহরণ তৈরি করুন

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

এছাড়াও, আপনার অ্যাপের পদ্ধতি গণনা এবং minSdkVersion (যেমন ধাপ 2 এ ব্যাখ্যা করা হয়েছে) দ্বারা প্রয়োজন হলে মাল্টিডেক্স সক্ষম করুন।

এখানে একটি উদাহরণ:

app/src/main/java/com/example/ project name /MyActivity.java

...

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 PlayerView playerView;
  private ExoPlayer player;
  private ImaServerSideAdInsertionMediaSource.AdsLoader adsLoader;
  private ImaServerSideAdInsertionMediaSource.AdsLoader.State adsLoaderState;

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

    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.CREATOR.fromBundle(
                adsLoaderStateBundle);
      }
    }
  }

}

প্লেয়ার শুরু করার পদ্ধতি যোগ করুন

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

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

এখানে একটি উদাহরণ:

app/src/main/java/com/example/ project name /MyActivity.java

public class MyActivity extends Activity {

  ...

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

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

    return adsLoaderBuilder.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 an ExoPlayer and set it as the player for content and ads.
    player = new ExoPlayer.Builder(this).setMediaSourceFactory(mediaSourceFactory).build();
    playerView.setPlayer(player);
    adsLoader.setPlayer(player);

    // Build an IMA SSAI media item to prepare the player with.
    Uri ssaiLiveUri =
        new ImaServerSideAdInsertionUriBuilder()
            .setAssetKey(SAMPLE_ASSET_KEY)
            .setFormat(CONTENT_TYPE_HLS) // Use CONTENT_TYPE_DASH for dash streams.
            .build();

    // Create the MediaItem to play, specifying the stream URI.
    MediaItem ssaiMediaItem = MediaItem.fromUri(ssaiLiveUri);

    // 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);
  }
}

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

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

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

app/src/main/java/com/example/ project name /MyActivity.java

public class MyActivity extends Activity {

  ...

  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();
  }

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

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

Android SDK সংস্করণ 24+ সমর্থন করতে:

24-এর কম Android SDK সংস্করণ সমর্থন করতে: - onResume() - onPause()

onStart() এবং onResume() মানচিত্র playerView.onResume() , এবং onStop() এবং onPause() মানচিত্র playerView.onPause() এ।

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

app/src/main/java/com/example/ project name /MyActivity.java

public class MyActivity extends Activity {

  ...

  @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());
    }
  }

  ...

}

VOD স্ট্রিম সেটআপ (ঐচ্ছিক)

যদি আপনার অ্যাপের বিজ্ঞাপনের সাথে VOD সামগ্রী চালানোর প্রয়োজন হয়, তাহলে আপনাকে নিম্নলিখিতগুলি করতে হবে:

  1. একটি VOD পরীক্ষার জন্য একটি CMS ID এবং Video ID যোগ করুন।
  2. ImaServerSideAdInsertionUriBuilder() ব্যবহার করে একটি SSAI VOD URI তৈরি করুন।
  3. আপনার প্লেয়ারের মিডিয়া আইটেম হিসাবে এই নতুন URI ব্যবহার করুন৷

app/src/main/java/com/example/ project name /MyActivity.java

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 SAMPLE_CMS_ID = "2528370";
  private static final String SAMPLE_VIDEO_ID = "tears-of-steel";

  ...

  private void initializePlayer() {

     ...

    Uri ssaiVodUri =
        new ImaServerSideAdInsertionUriBuilder()
            .setContentSourceId(SAMPLE_CMS_ID)
            .setVideoId(SAMPLE_VIDEO_ID)
            .setFormat(CONTENT_TYPE_HLS)
            .build();

    // Create the MediaItem to play, specifying the stream URI.
    MediaItem ssaiMediaItem = MediaItem.fromUri(ssaiVodUri);

    // 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);
  }

এটাই! আপনি এখন অনুরোধ করছেন এবং ExoPlayer IMA এক্সটেনশনের সাথে একটি মিডিয়া স্ট্রিম চালাচ্ছেন। সম্পূর্ণ কোডের জন্য GitHub-এ Android DAI নমুনাগুলি দেখুন।