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

IMA SDKগুলি আপনার ওয়েবসাইট এবং অ্যাপগুলিতে মাল্টিমিডিয়া বিজ্ঞাপনগুলিকে একীভূত করা সহজ করে তোলে৷ IMA SDK যেকোন VAST-সঙ্গী বিজ্ঞাপন সার্ভার থেকে বিজ্ঞাপনের অনুরোধ করতে পারে এবং আপনার অ্যাপে বিজ্ঞাপন প্লেব্যাক পরিচালনা করতে পারে। IMA ক্লায়েন্ট-সাইড SDK-এর সাথে, আপনি সামগ্রী ভিডিও প্লেব্যাকের নিয়ন্ত্রণ বজায় রাখেন, যখন SDK বিজ্ঞাপন প্লেব্যাক পরিচালনা করে। বিজ্ঞাপনগুলি অ্যাপের বিষয়বস্তু ভিডিও প্লেয়ারের উপরে অবস্থান করা একটি পৃথক ভিডিও প্লেয়ারে চলে৷

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

IMA ক্লায়েন্ট-সাইড ওভারভিউ

IMA ক্লায়েন্ট-সাইড বাস্তবায়নে চারটি প্রধান SDK উপাদান জড়িত, যা এই নির্দেশিকায় প্রদর্শিত হয়েছে:

  • AdDisplayContainer : একটি কন্টেইনার অবজেক্ট যা IMA বিজ্ঞাপন UI উপাদানগুলিকে কোথায় রেন্ডার করে এবং সক্রিয় ভিউ এবং ওপেন মেজারমেন্ট সহ দর্শনযোগ্যতা পরিমাপ করে তা নির্দিষ্ট করে৷
  • AdsLoader : একটি বস্তু যা বিজ্ঞাপনের অনুরোধ করে এবং বিজ্ঞাপনের অনুরোধের প্রতিক্রিয়া থেকে ইভেন্ট পরিচালনা করে। আপনার শুধুমাত্র একটি বিজ্ঞাপন লোডার ইনস্ট্যান্টিয়েট করা উচিত, যা অ্যাপ্লিকেশনের সারাজীবন জুড়ে পুনরায় ব্যবহার করা যেতে পারে।
  • AdsRequest : একটি বস্তু যা একটি বিজ্ঞাপন অনুরোধ সংজ্ঞায়িত করে। বিজ্ঞাপনের অনুরোধগুলি VAST বিজ্ঞাপন ট্যাগের জন্য URL উল্লেখ করে, সেইসাথে অতিরিক্ত প্যারামিটার, যেমন বিজ্ঞাপনের মাত্রা।
  • AdsManager : একটি বস্তু যা বিজ্ঞাপনের অনুরোধের প্রতিক্রিয়া ধারণ করে, বিজ্ঞাপন প্লেব্যাক নিয়ন্ত্রণ করে এবং SDK দ্বারা চালিত বিজ্ঞাপন ইভেন্টগুলি শোনে।

পূর্বশর্ত

আপনি শুরু করার আগে, আপনার Android Studio 3.0 বা উচ্চতর দরকার।

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

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

  1. অ্যান্ড্রয়েড স্টুডিও শুরু করুন।
  2. একটি নতুন অ্যান্ড্রয়েড স্টুডিও প্রকল্প শুরু করুন নির্বাচন করুন।
  3. আপনার প্রকল্প চয়ন করুন পৃষ্ঠায়, খালি কার্যকলাপ টেমপ্লেট নির্বাচন করুন।
  4. পরবর্তী ক্লিক করুন.
  5. আপনার প্রকল্প কনফিগার করুন পৃষ্ঠায়, আপনার প্রকল্পের নাম দিন এবং ভাষার জন্য জাভা নির্বাচন করুন।
  6. শেষ ক্লিক করুন.

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

প্রথমত, অ্যাপ্লিকেশন-স্তরের build.gradle ফাইলে, নির্ভরতা বিভাগে এক্সটেনশনের জন্য আমদানি যোগ করুন। ExoPlayer IMA এক্সটেনশনের আকারের কারণে, এখানে মাল্টিডেক্স বাস্তবায়ন এবং সক্ষম করুন। minSdkVersion 20 বা তার নিচে সেট করা অ্যাপগুলির জন্য এটি প্রয়োজনীয়। এছাড়াও, জাভা সংস্করণ সামঞ্জস্যের তথ্য নির্দিষ্ট করতে নতুন compileOptions যোগ করুন।

apply plugin: 'com.android.application'

android {
    namespace 'com.google.ads.interactivemedia.v3.samples.exoplayerexample'
    compileSdk 36

    // Java 17 required by Gradle 8+
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }

    defaultConfig {
        applicationId "com.google.ads.interactivemedia.v3.samples.exoplayerexample"
        minSdkVersion 21
        targetSdkVersion 36
        multiDexEnabled true
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

repositories {
    google()
    mavenCentral()
}

dependencies {
    def media3_version = "1.8.0"
    implementation "androidx.media3:media3-ui:$media3_version"
    implementation "androidx.media3:media3-exoplayer:$media3_version"

    // The library adds the IMA ExoPlayer integration for ads.
    implementation "androidx.media3:media3-exoplayer-ima:$media3_version"

    implementation 'androidx.multidex:multidex:2.0.1'
}

3. বিজ্ঞাপন UI কন্টেইনার তৈরি করুন৷

একটি androidx.media3.ui.PlayerView তৈরি করে ExoPlayer PlayerView হিসেবে ব্যবহার করার জন্য ভিউ তৈরি করুন। এছাড়াও, 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: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>

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

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

import static android.os.Build.VERSION.SDK_INT;

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.datasource.DataSource;
import androidx.media3.datasource.DefaultDataSource;
import androidx.media3.exoplayer.ExoPlayer;
import androidx.media3.exoplayer.ima.ImaAdsLoader;
import androidx.media3.exoplayer.source.DefaultMediaSourceFactory;
import androidx.media3.exoplayer.source.MediaSource;
import androidx.media3.ui.PlayerView;
import androidx.multidex.MultiDex;
import com.google.ads.interactivemedia.v3.api.AdEvent;
import com.google.ads.interactivemedia.v3.api.ImaSdkFactory;
import com.google.ads.interactivemedia.v3.api.ImaSdkSettings;

তারপর, PlayerView , ExoPlayer , ImaAdsLoader , এবং ImaSdkSettings জন্য ব্যক্তিগত ভেরিয়েবল যোগ করে Activity বাড়ানোর জন্য MainActivity ক্লাস আপডেট করুন:

/** Main Activity. */
@SuppressLint("UnsafeOptInUsageError")
/* @SuppressLint is needed for new media3 APIs. */
public class MyActivity extends Activity {

  private static final String SAMPLE_VIDEO_URL =
      "https://storage.googleapis.com/gvabox/media/samples/stock.mp4";
  private static final String SAMPLE_VAST_TAG_URL =
      "https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/"
          + "single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90"
          + "&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&correlator=";
  private static final String LOG_TAG = "ImaExoPlayerExample";

  private PlayerView playerView;
  private TextView logText;
  private ExoPlayer player;
  private ImaAdsLoader adsLoader;
  private ImaSdkSettings imaSdkSettings;

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

onCreate পদ্ধতিটি ওভাররাইট করুন এবং বিজ্ঞাপন ট্যাগ URL এর সাথে একটি নতুন adsLoader অবজেক্ট তৈরি করতে প্রয়োজনীয় পরিবর্তনশীল অ্যাসাইনমেন্ট যোগ করুন।

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

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

  // Create an AdsLoader.
  adsLoader =
      new ImaAdsLoader.Builder(/* context= */ this)
          .setAdEventListener(buildAdEventListener())
          .setImaSdkSettings(getImaSdkSettings())
          .build();
}

ডিবাগিংয়ের জন্য IMA ইভেন্ট লগ করার জন্য একটি AdEventListener অবজেক্ট ফেরত দিতে buildAdEventListener() পদ্ধতি তৈরি করুন। ExoPlayer IMA এক্সটেনশন ইতিমধ্যে IMA ইভেন্টগুলি পরিচালনা করে এবং কাজ করার জন্য এখানে অতিরিক্ত কিছুর প্রয়োজন নেই৷

public AdEvent.AdEventListener buildAdEventListener() {
  logText = findViewById(R.id.logText);
  logText.setMovementMethod(new ScrollingMovementMethod());

  return event -> {
    AdEvent.AdEventType eventType = event.getType();
    if (eventType == AdEvent.AdEventType.AD_PROGRESS) {
      return;
    }
    String log = "IMA event: " + eventType;
    if (logText != null) {
      logText.append(log + "\n");
    }
    Log.i(LOG_TAG, log);
  };
}

যেকোনো IMA SDK সেটিংস সেট করতে একটি ImaSdkSettings অবজেক্ট ফেরত দিতে getImaSdkSettings() সহায়ক পদ্ধতি তৈরি করুন:

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

6. প্লেয়ার শুরু করুন এবং ছেড়ে দিন

প্লেয়ার রিলিজ এবং আরম্ভ করার পদ্ধতি যোগ করুন। initializePlayer() পদ্ধতিতে, ExoPlayer তৈরি করুন। তারপরে, AdsMediaSource তৈরি করুন এবং প্লেয়ারে সেট করুন:

private void releasePlayer() {
  adsLoader.setPlayer(null);
  playerView.setPlayer(null);
  player.release();
  player = null;
}

private void initializePlayer() {
  // Set up the factory for media sources, passing the ads loader and ad view providers.
  DataSource.Factory dataSourceFactory = new DefaultDataSource.Factory(this);

  MediaSource.Factory mediaSourceFactory =
      new DefaultMediaSourceFactory(dataSourceFactory)
          .setLocalAdInsertionComponents(unusedAdTagUri -> adsLoader, playerView);

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

  // Create the MediaItem to play, specifying the content URI and ad tag URI.
  Uri contentUri = Uri.parse(SAMPLE_VIDEO_URL);
  Uri adTagUri = Uri.parse(SAMPLE_VAST_TAG_URL);
  MediaItem mediaItem =
      new MediaItem.Builder()
          .setUri(contentUri)
          .setAdsConfiguration(new MediaItem.AdsConfiguration.Builder(adTagUri).build())
          .build();

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

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

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

অবশেষে, খেলোয়াড়ের জীবনচক্র ইভেন্টগুলির জন্য কলব্যাক তৈরি করুন:

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

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

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

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

@Override
protected void onDestroy() {
  adsLoader.release();

  super.onDestroy();
}

আপনি এখন সফলভাবে IMA SDK-এর সাথে বিজ্ঞাপনের অনুরোধ এবং প্রদর্শন করছেন৷ আরও উন্নত বৈশিষ্ট্য সম্পর্কে জানতে, GitHub-এ অন্যান্য গাইড বা নমুনাগুলি অন্বেষণ করুন।