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

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

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

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

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

  • AdDisplayContainer : একটি কন্টেইনার অবজেক্ট যেখানে বিজ্ঞাপন রেন্ডার করা হয়।
  • 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 যোগ করুন।

app/build.gradle
android {
    namespace 'com.google.ads.interactivemedia.v3.samples.exoplayerexample'
    compileSdkVersion 34

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }
  }

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

    ...
}
dependencies {
    implementation 'androidx.multidex:multidex:2.0.1'
    implementation 'androidx.media3:media3-ui:1.3.1'
    implementation 'androidx.media3:media3-exoplayer:1.3.1'
    implementation 'androidx.media3:media3-exoplayer-ima:1.3.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>

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

একটি উপযুক্ত আইডি সহ একটি StyledPlayerView অবজেক্ট তৈরি করে ExoPlayer PlayerView হিসাবে ব্যবহার করার জন্য ভিউ তৈরি করুন। এছাড়াও androidx.constraintlayout.widget.ConstraintLayout একটি LinearLayout এ পরিবর্তন করুন।

app/src/main/res/layout/activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <androidx.media3.ui.PlayerView
        android:id="@+id/player_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</LinearLayout>

4. বিজ্ঞাপনের অনুরোধের জন্য আপনার সামগ্রী URL এবং বিজ্ঞাপন ট্যাগ URL যোগ করুন৷

আপনার সামগ্রী URL এবং VAST বিজ্ঞাপন ট্যাগ URL সংরক্ষণ করতে strings.xml এ এন্ট্রি যোগ করুন৷

app/src/main/res/values/strings.xml
<resources>
    <string name="app_name">Your_Project_Name</string>
    <string name="content_url"><![CDATA[https://storage.googleapis.com/gvabox/media/samples/stock.mp4]]></string>
    <string name="ad_tag_url"><![CDATA[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&impl=s&correlator=]]></string>

</resources>

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

ExoPlayer এক্সটেনশনের জন্য আমদানি বিবৃতি যোগ করুন। তারপরে, PlayerView , SimpleExoPlayer , এবং ImaAdsLoader এর জন্য ব্যক্তিগত ভেরিয়েবল যোগ করে Activity বাড়ানোর জন্য MainActivity ক্লাস আপডেট করুন।

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

import android.app.Activity;
import android.net.Uri;
import android.os.Bundle;
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.ImaAdsLoader;
import androidx.media3.exoplayer.source.DefaultMediaSourceFactory;
import androidx.media3.exoplayer.source.MediaSource;
import androidx.media3.ui.PlayerView;
import androidx.multidex.MultiDex;

...

public class MainActivity extends Activity {

  private PlayerView playerView;
  private ExoPlayer player;
  private ImaAdsLoader adsLoader;

}

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

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

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

public class MainActivity extends Activity {

  private PlayerView playerView;
  private ExoPlayer player;
  private ImaAdsLoader adsLoader;

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

    playerView = findViewById(R.id.player_view);

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

  public AdEvent.AdEventListener buildAdEventListener() {

    AdEvent.AdEventListener imaAdEventListener = event -> {
      AdEvent.AdEventType eventType = event.getType();
      // Log IMA events for debugging.
      // The ExoPlayer IMA extension already handles IMA events and does not need anything
      // additional here to function.
    };

    return imaAdEventListener;
  }

}

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

প্লেয়ার শুরু এবং প্রকাশ করার পদ্ধতি যোগ করুন। ইনিশিয়ালাইজ পদ্ধতিতে, SimpleExoPlayer তৈরি করুন। তারপরে, AdsMediaSource তৈরি করুন এবং প্লেয়ারে সেট করুন।

app/src/main/java/com/example/ project name /MainActivity.java
public class MainActivity extends Activity {

  ...

  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(getString(R.string.content_url));
    Uri adTagUri = Uri.parse(getString(R.string.ad_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);
  }
}

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

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

  • onStart
  • onResume
  • onStop
  • onPause
  • onDestroy
app/src/main/java/com/example/ project name /MainActivity.java
public class MainActivity extends Activity {

  private PlayerView playerView;
  private SimpleExoPlayer player;
  private ImaAdsLoader adsLoader;

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

      playerView = findViewById(R.id.player_view);

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

  @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
  protected void onDestroy() {
    super.onDestroy();
    adsLoader.release();
  }

  ...

}

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