हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव/राय देने के लिए, Google विज्ञापन और मेज़रमेंट कम्यूनिटी सर्वर में Ad Manager के आधिकारिक Discord चैनल से जुड़ें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

डीआई के लिए IMA SDK टूल सेट अप करना

प्लैटफ़ॉर्म चुनें: HTML5 Android iOS tvOS Cast Roku

IMA SDK की मदद से, अपनी वेबसाइटों और ऐप्लिकेशन में मल्टीमीडिया विज्ञापन आसानी से इंटिग्रेट किए जा सकते हैं. IMA SDK, वीएएसटी के साथ काम करने वाले किसी भी विज्ञापन सर्वर से विज्ञापनों का अनुरोध कर सकते हैं. साथ ही, आपके ऐप्लिकेशन में विज्ञापन दिखाने की सुविधा को मैनेज कर सकते हैं. IMA DAI SDK की मदद से, ऐप्लिकेशन विज्ञापन और कॉन्टेंट वीडियो के लिए स्ट्रीम का अनुरोध करते हैं. यह कॉन्टेंट, वीओडी या लाइव कॉन्टेंट में से कोई भी हो सकता है. इसके बाद, SDK टूल एक साथ वीडियो स्ट्रीम दिखाता है, ताकि आपको अपने ऐप्लिकेशन में विज्ञापन और कॉन्टेंट वीडियो के बीच स्विच करने की ज़रूरत न पड़े.

डीएआई का वह समाधान चुनें जिसमें आपकी दिलचस्पी है

डीएआई की पूरी सेवा

इस गाइड में, आईएमए डीएआई एसडीके को किसी सामान्य वीडियो प्‍लेयर ऐप्लिकेशन में इंटिग्रेट करने का तरीका बताया गया है. अगर आपको इंटिग्रेशन का पूरा सैंपल देखना है या साथ-साथ इंटिग्रेट करना है, तो GitHub से BasicExample डाउनलोड करें.

आईएमए डीएआई की खास जानकारी

आईएमए डीएआई को लागू करने के लिए, एसडीके के चार मुख्य कॉम्पोनेंट का इस्तेमाल किया जाता है. इनके बारे में इस गाइड में बताया गया है:

StreamDisplayContainer: यह एक कंटेनर ऑब्जेक्ट है, जो वीडियो चलाने वाले एलिमेंट के ऊपर दिखता है. इसमें विज्ञापन के यूज़र इंटरफ़ेस (यूआई) एलिमेंट शामिल होते हैं.
AdsLoader: यह ऐसा ऑब्जेक्ट है जो स्ट्रीम का अनुरोध करता है और स्ट्रीम के अनुरोध के रिस्पॉन्स ऑब्जेक्ट से ट्रिगर होने वाले इवेंट को हैंडल करता है. आपको सिर्फ़ एक विज्ञापन लोडर को इंस्टैंशिएट करना चाहिए. इसका इस्तेमाल, ऐप्लिकेशन के पूरे लाइफ़टाइम में किया जा सकता है.
StreamRequest: यह एक ऐसा ऑब्जेक्ट है जो स्ट्रीम के अनुरोध के बारे में बताता है. स्ट्रीम करने के अनुरोध, वीडियो-ऑन-डिमांड या लाइव स्ट्रीम के लिए किए जा सकते हैं. लाइव स्ट्रीम के अनुरोधों में ऐसेट कुंजी के बारे में बताया जाता है. वहीं, वीओडी के अनुरोधों में सीएमएस आईडी और वीडियो आईडी के बारे में बताया जाता है. दोनों तरह के अनुरोधों में, एपीआई कुंजी शामिल की जा सकती है. इसकी ज़रूरत, चुनी गई स्ट्रीम को ऐक्सेस करने के लिए होती है. साथ ही, इसमें Google Ad Manager नेटवर्क कोड भी शामिल किया जा सकता है. इसकी ज़रूरत, IMA SDK को विज्ञापन आइडेंटिफ़ायर मैनेज करने के लिए होती है. ये आइडेंटिफ़ायर, Google Ad Manager की सेटिंग में तय किए जाते हैं.
StreamManager: यह एक ऐसा ऑब्जेक्ट है जो डाइनैमिक ऐड इंसर्शन वाली स्ट्रीम और डीएआई बैकएंड के साथ इंटरैक्शन को मैनेज करता है. स्ट्रीम मैनेजर, ट्रैकिंग पिंग को भी मैनेज करता है. साथ ही, स्ट्रीम और विज्ञापन इवेंट को पब्लिशर को भेजता है.

ज़रूरी शर्तें

Android Studio
एसडीके टूल इंटिग्रेशन के लिए सैंपल वीडियो प्लेयर ऐप्लिकेशन

सैंपल वीडियो प्लेयर ऐप्लिकेशन डाउनलोड और चलाना

सैंपल के तौर पर मिले ऐप्लिकेशन में, काम करने वाला एक वीडियो प्लेयर दिया गया है. यह एचएलएस वीडियो चलाता है. IMA DAI SDK की डीएआई सुविधाओं को इंटिग्रेट करने के लिए, इसे शुरुआती पॉइंट के तौर पर इस्तेमाल करें.

सैंपल वीडियो प्लेयर ऐप्लिकेशन डाउनलोड करें और उसे एक्सट्रैक्ट करें.
Android Studio शुरू करें और कोई मौजूदा Android Studio प्रोजेक्ट खोलें को चुनें. अगर Android Studio पहले से चल रहा है, तो फ़ाइल > नया > प्रोजेक्ट इंपोर्ट करें को चुनें. इसके बाद, SampleVideoPlayer/build.gradle को चुनें.
Tools > Android > Sync Project with Gradle Files को चुनकर, Gradle सिंक करें.
पक्का करें कि प्लेयर ऐप्लिकेशन, Android डिवाइस या Android वर्चुअल डिवाइस पर कंपाइल और चलता हो. इसके लिए, Run > Run 'app' का इस्तेमाल करें. वीडियो स्ट्रीम को चलने से पहले लोड होने में कुछ समय लग सकता है.

सैंपल वीडियो प्लेयर की जांच करना

सैंपल वीडियो प्लेयर में, अब तक IMA डीएआई एसडीके इंटिग्रेशन कोड शामिल नहीं किया गया है. सैंपल के तौर पर मिले ऐप्लिकेशन में दो मुख्य हिस्से होते हैं:

samplevideoplayer/SampleVideoPlayer.java: यह ExoPlayer पर आधारित एचएलएस प्लेयर है. यह आईएमए डीएआई इंटिग्रेशन के लिए आधार का काम करता है.
videoplayerapp/MyActivity.java: इस गतिविधि से वीडियो प्लेयर बनता है और इसे Context और media3.ui.PlayerView पास किया जाता है.

प्लेयर ऐप्लिकेशन में आईएमए डीएआई एसडीके जोड़ना

आपको IMA डीएआई एसडीके का रेफ़रंस भी शामिल करना होगा. Android Studio में, ऐप्लिकेशन-लेवल की build.gradle फ़ाइल में यहां दिया गया कोड जोड़ें. यह फ़ाइल app/build.gradle में मौजूद होती है. IMA SDK के लिए, लाइब्रेरी डिसुगरिंग की सुविधा चालू होनी चाहिए. इसके लिए, आपको coreLibraryDesugaringEnabled true सेट करना होगा और build.gradle फ़ाइल में 'com.android.tools:desugar_jdk_libs' को डिपेंडेंसी के तौर पर जोड़ना होगा. ज़्यादा जानकारी के लिए, nio स्पेसिफ़िकेशन के साथ डिसुगरिंग के ज़रिए उपलब्ध Java 11+ API देखें.

repositories {
    google()
    mavenCentral()
}

dependencies {
    def media3_version = "1.11.0"
    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.5")
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:2.3.21"))
    implementation("androidx.appcompat:appcompat:1.8.0")
    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")
    implementation("androidx.mediarouter:mediarouter:1.8.1")
    implementation("com.google.ads.interactivemedia.v3:interactivemedia:3.40.0")
}build.gradle

IMA डीएआई एसडीके टूल को इंटिग्रेट करना

videoplayerapp पैकेज (app/java/com.google.ads.interactivemedia.v3.samples/videoplayerapp/ में) में SampleAdsWrapper नाम की नई क्लास बनाएं. इससे मौजूदा SampleVideoPlayer को रैप किया जा सकेगा. साथ ही, IMA DAI को लागू करने वाला लॉजिक जोड़ा जा सकेगा. इसके लिए, आपको पहले एक AdsLoader बनाना होगा. इसका इस्तेमाल, डीएआई स्ट्रीम का अनुरोध करने के लिए किया जाता है.

इस स्निपेट में, HLS और DASH के साथ-साथ लाइव और वीओडी स्ट्रीम के लिए सैंपल पैरामीटर शामिल हैं. यह सेट करने के लिए कि कौनसी स्ट्रीम चलाई जा रही है, CONTENT_TYPE वैरिएबल को अपडेट करें.

package com.google.ads.interactivemedia.v3.samples.videoplayerapp;

import android.annotation.SuppressLint;
import android.content.Context;
import android.view.ViewGroup;
import android.webkit.WebView;
import androidx.annotation.Nullable;
import com.google.ads.interactivemedia.v3.api.AdErrorEvent;
import com.google.ads.interactivemedia.v3.api.AdEvent;
import com.google.ads.interactivemedia.v3.api.AdsLoader;
import com.google.ads.interactivemedia.v3.api.AdsManagerLoadedEvent;
import com.google.ads.interactivemedia.v3.api.CuePoint;
import com.google.ads.interactivemedia.v3.api.ImaSdkFactory;
import com.google.ads.interactivemedia.v3.api.StreamDisplayContainer;
import com.google.ads.interactivemedia.v3.api.StreamManager;
import com.google.ads.interactivemedia.v3.api.StreamRequest;
import com.google.ads.interactivemedia.v3.api.StreamRequest.StreamFormat;
import com.google.ads.interactivemedia.v3.api.player.VideoProgressUpdate;
import com.google.ads.interactivemedia.v3.api.player.VideoStreamPlayer;
import com.google.ads.interactivemedia.v3.samples.samplevideoplayer.SampleVideoPlayer;
import com.google.ads.interactivemedia.v3.samples.samplevideoplayer.SampleVideoPlayer.SampleVideoPlayerCallback;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;

/** This class adds ad-serving support to Sample HlsVideoPlayer */
@SuppressLint("UnsafeOptInUsageError")
/* @SuppressLint is needed for new media3 APIs. */
public class SampleAdsWrapper
    implements AdEvent.AdEventListener, AdErrorEvent.AdErrorListener, AdsLoader.AdsLoadedListener {

  // Live HLS stream asset key.
  private static final String TEST_HLS_ASSET_KEY = "c-rArva4ShKVIAkNfy6HUQ";

  // Live DASH stream asset key.
  private static final String TEST_DASH_ASSET_KEY = "PSzZMzAkSXCmlJOWDmRj8Q";

  // VOD HLS content source and video IDs.
  private static final String TEST_HLS_CONTENT_SOURCE_ID = "2548831";
  private static final String TEST_HLS_VIDEO_ID = "tears-of-steel";

  // VOD DASH content source and video IDs.
  private static final String TEST_DASH_CONTENT_SOURCE_ID = "2559737";
  private static final String TEST_DASH_VIDEO_ID = "tos-dash";

  private static final String NETWORK_CODE = "21775744923";

  private static final String PLAYER_TYPE = "DAISamplePlayer";

  private enum ContentType {
    LIVE_HLS,
    LIVE_DASH,
    VOD_HLS,
    VOD_DASH,
  }

  // Set CONTENT_TYPE to the associated enum for the stream type you would like to test.
  private static final ContentType CONTENT_TYPE = ContentType.VOD_HLS;

  /** Log interface, so we can output the log commands to the UI or similar. */
  public interface Logger {
    void log(String logMessage);
  }

  private final ImaSdkFactory sdkFactory;
  private AdsLoader adsLoader;
  private StreamManager streamManager;
  private final List<VideoStreamPlayer.VideoStreamPlayerCallback> playerCallbacks;

  private final SampleVideoPlayer videoPlayer;
  private final Context context;
  private final ViewGroup adUiContainer;

  private String fallbackUrl;
  private Logger logger;

  /**
   * Creates a new SampleAdsWrapper that implements IMA direct-ad-insertion.
   *
   * @param context the app's context.
   * @param videoPlayer underlying HLS video player.
   * @param adUiContainer ViewGroup in which to display the ad's UI.
   */
  public SampleAdsWrapper(Context context, SampleVideoPlayer videoPlayer, ViewGroup adUiContainer) {
    this.videoPlayer = videoPlayer;
    this.context = context;
    this.adUiContainer = adUiContainer;
    sdkFactory = ImaSdkFactory.getInstance();
    playerCallbacks = new ArrayList<>();
    createAdsLoader();
  }

  private void enableWebViewDebugging() {
    WebView.setWebContentsDebuggingEnabled(true);
  }

  private void createAdsLoader() {
    enableWebViewDebugging();
    VideoStreamPlayer videoStreamPlayer = createVideoStreamPlayer();
    StreamDisplayContainer displayContainer =
        ImaSdkFactory.createStreamDisplayContainer(adUiContainer, videoStreamPlayer);
    videoPlayer.setSampleVideoPlayerCallback(createSampleVideoPlayerCallback());
    adsLoader =
        sdkFactory.createAdsLoader(context, MyActivity.getImaSdkSettings(), displayContainer);
  }

  public void requestAndPlayAds() {
    adsLoader.addAdErrorListener(this);
    adsLoader.addAdsLoadedListener(this);
    adsLoader.requestStream(buildStreamRequest());
  }
SampleAdsWrapper.java

createSampleVideoPlayerCallback() इंटरफ़ेस का इंस्टेंस बनाने के लिए, SampleVideoPlayerCallback हेल्पर मेथड बनाएं. यह VideoStreamPlayer.VideoStreamPlayerCallback को बढ़ाता है.

डीएआई के साथ काम करने के लिए, प्लेयर को आईडी3 इवेंट, IMA डीएआई एसडीके को पास करने होंगे. callback.onUserTextReceived() तरीके से ऐसा किया जाता है. यहां दिए गए सैंपल कोड में इसका उदाहरण दिया गया है.

private SampleVideoPlayerCallback createSampleVideoPlayerCallback() {
  return new SampleVideoPlayerCallback() {
    @Override
    public void onUserTextReceived(String userText) {
      for (VideoStreamPlayer.VideoStreamPlayerCallback callback : playerCallbacks) {
        callback.onUserTextReceived(userText);
      }
    }

    @Override
    public void onSeek(int windowIndex, long positionMs) {
      // See if we would seek past an ad, and if so, jump back to it.
      long newSeekPositionMs = positionMs;
      if (streamManager != null) {
        CuePoint prevCuePoint = streamManager.getPreviousCuePointForStreamTimeMs(positionMs);
        if (prevCuePoint != null && !prevCuePoint.isPlayed()) {
          newSeekPositionMs = prevCuePoint.getStartTimeMs();
        }
      }
      videoPlayer.seekTo(windowIndex, newSeekPositionMs);
    }

    @Override
    public void onContentComplete() {
      for (VideoStreamPlayer.VideoStreamPlayerCallback callback : playerCallbacks) {
        callback.onContentComplete();
      }
    }

    @Override
    public void onPause() {
      for (VideoStreamPlayer.VideoStreamPlayerCallback callback : playerCallbacks) {
        callback.onPause();
      }
    }

    @Override
    public void onResume() {
      for (VideoStreamPlayer.VideoStreamPlayerCallback callback : playerCallbacks) {
        callback.onResume();
      }
    }

    @Override
    public void onVolumeChanged(int percentage) {
      for (VideoStreamPlayer.VideoStreamPlayerCallback callback : playerCallbacks) {
        callback.onVolumeChanged(percentage);
      }
    }
  };
}
SampleAdsWrapper.java

SteamRequest बनाने के लिए, buildStreamRequest() तरीका जोड़ें. यह तरीका, CONTENT_TYPE वैरिएबल को सेट करने के तरीके के आधार पर, अलग-अलग स्ट्रीम के बीच स्विच करता है. इस गाइड में इस्तेमाल की गई डिफ़ॉल्ट स्ट्रीम, IMA की सैंपल वीओडी एचएलएस स्ट्रीम है.

@Nullable
private StreamRequest buildStreamRequest() {
  StreamRequest request;
  switch (CONTENT_TYPE) {
    case LIVE_HLS:
      // Live HLS stream request.
      return sdkFactory.createLiveStreamRequest(TEST_HLS_ASSET_KEY, null, NETWORK_CODE);
    case LIVE_DASH:
      // Live DASH stream request.
      return sdkFactory.createLiveStreamRequest(TEST_DASH_ASSET_KEY, null, NETWORK_CODE);
    case VOD_HLS:
      // VOD HLS request.
      request =
          sdkFactory.createVodStreamRequest(
              TEST_HLS_CONTENT_SOURCE_ID, TEST_HLS_VIDEO_ID, null, NETWORK_CODE);
      request.setFormat(StreamFormat.HLS);
      return request;
    case VOD_DASH:
      // VOD DASH request.
      request =
          sdkFactory.createVodStreamRequest(
              TEST_DASH_CONTENT_SOURCE_ID, TEST_DASH_VIDEO_ID, null, NETWORK_CODE);
      request.setFormat(StreamFormat.DASH);
      return request;
  }
  // Content type not selected.
  return null;
}
SampleAdsWrapper.java

स्ट्रीम चलाने के लिए, आपको VideoStreamPlayer की भी ज़रूरत होगी. इसलिए, createVideoStreamPlayer() तरीका जोड़ें. यह एक ऐसी एनॉनिमस क्लास बनाता है जो VideoStreamPlayer को लागू करती है.

private VideoStreamPlayer createVideoStreamPlayer() {
  return new VideoStreamPlayer() {
    @Override
    public void loadUrl(String url, List<HashMap<String, String>> subtitles) {
      videoPlayer.setStreamUrl(url);
      videoPlayer.play();
    }

    @Override
    public void pause() {
      // Pause player.
      videoPlayer.pause();
    }

    @Override
    public void resume() {
      // Resume player.
      videoPlayer.play();
    }

    @Override
    public int getVolume() {
      // Make the video player play at the current device volume.
      return 100;
    }

    @Override
    public void addCallback(VideoStreamPlayerCallback videoStreamPlayerCallback) {
      playerCallbacks.add(videoStreamPlayerCallback);
    }

    @Override
    public void removeCallback(VideoStreamPlayerCallback videoStreamPlayerCallback) {
      playerCallbacks.remove(videoStreamPlayerCallback);
    }

    @Override
    public void onAdBreakStarted() {
      // Disable player controls.
      videoPlayer.enableControls(false);
      log("Ad Break Started\n");
    }

    @Override
    public void onAdBreakEnded() {
      // Re-enable player controls.
      if (videoPlayer != null) {
        videoPlayer.enableControls(true);
      }
      log("Ad Break Ended\n");
    }

    @Override
    public void onAdPeriodStarted() {
      log("Ad Period Started\n");
    }

    @Override
    public void onAdPeriodEnded() {
      log("Ad Period Ended\n");
    }

    @Override
    public void seek(long timeMs) {
      // An ad was skipped. Skip to the content time.
      videoPlayer.seekTo(timeMs);
      log("seek");
    }

    @Override
    public VideoProgressUpdate getContentProgress() {
      return new VideoProgressUpdate(
          videoPlayer.getCurrentPositionMs(), videoPlayer.getDuration());
    }
  };
}
SampleAdsWrapper.java

ज़रूरी लिसनर लागू करें और गड़बड़ी की जानकारी देने की सुविधा जोड़ें.

AdErrorListener को लागू करने के तरीके पर ध्यान दें, क्योंकि अगर विज्ञापन नहीं चलते हैं, तो यह फ़ॉलबैक यूआरएल को कॉल करता है. कॉन्टेंट और विज्ञापन एक ही स्ट्रीम में होते हैं. इसलिए, अगर DAI स्ट्रीम में कोई गड़बड़ी होती है, तो आपको फ़ॉलबैक स्ट्रीम को कॉल करने के लिए तैयार रहना होगा.

/** AdErrorListener implementation */
@Override
public void onAdError(AdErrorEvent event) {
  log(String.format("Error: %s\n", event.getError().getMessage()));
  // play fallback URL.
  log("Playing fallback Url\n");
  videoPlayer.setStreamUrl(fallbackUrl);
  videoPlayer.enableControls(true);
  videoPlayer.play();
}

/** AdEventListener implementation */
@Override
public void onAdEvent(AdEvent event) {
  switch (event.getType()) {
    case AD_PROGRESS:
      // Do nothing or else log will be filled by these messages.
      break;
    default:
      log(String.format("Event: %s\n", event.getType()));
      break;
  }
}

/** AdsLoadedListener implementation */
@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent event) {
  streamManager = event.getStreamManager();
  streamManager.addAdErrorListener(this);
  streamManager.addAdEventListener(this);
  streamManager.init();
}

/** Sets fallback URL in case ads stream fails. */
void setFallbackUrl(String url) {
  fallbackUrl = url;
}
SampleAdsWrapper.java

लॉगिंग के लिए कोड जोड़ें.

/** Sets logger for displaying events to screen. Optional. */
void setLogger(Logger logger) {
  this.logger = logger;
}

private void log(String message) {
  if (logger != null) {
    logger.log(message);
  }
}SampleAdsWrapper.java

SampleAdsWrapper को इंस्टैंशिएट और कॉल करने के लिए, videoplayerapp में MyActivity में बदलाव करें. इसके अलावा, ImaSdkSettings इंस्टेंस बनाने के लिए, हेल्पर तरीके का इस्तेमाल करके ImaSdkFactory.initialize() पर कॉल करें.

अहम जानकारी: IMA को लोड होने में लगने वाले समय को कम करने के लिए, ऐप्लिकेशन के लाइफ़साइकल में जल्द से जल्द ImaSdkFactory.initialize() मेथड को कॉल करें. इस तरीके को जल्दी कॉल करने से, IMA को पहली स्ट्रीम के अनुरोध से पहले ज़रूरी संसाधन लोड करने के लिए ज़्यादा समय मिलता है. ImaSdkFactory.initialize() मेथड कॉल, ImaSdkSettings इंस्टेंस को स्वीकार करता है. पक्का करें कि यहां और AdsLoader इंस्टेंस बनाते समय, एक जैसी सेटिंग वैल्यू का इस्तेमाल किया गया हो. इस उदाहरण में, getImaSdkSettings() हेल्पर तरीके का इस्तेमाल किया गया है, ताकि यह पक्का किया जा सके कि सेटिंग की वैल्यू एक जैसी हैं. ज़्यादा जानकारी के लिए, IMA को लोड होने में लगने वाले समय को ऑप्टिमाइज़ करने से जुड़ी गाइड> देखें.

package com.google.ads.interactivemedia.v3.samples.videoplayerapp;

import android.annotation.SuppressLint;
import android.app.Activity;
import android.content.res.Configuration;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.ImageButton;
import android.widget.ScrollView;
import android.widget.TextView;
import com.google.ads.interactivemedia.v3.api.ImaSdkFactory;
import com.google.ads.interactivemedia.v3.api.ImaSdkSettings;
import com.google.ads.interactivemedia.v3.samples.samplevideoplayer.SampleVideoPlayer;

/** Main Activity that plays media using {@link SampleVideoPlayer}. */
@SuppressLint("UnsafeOptInUsageError")
/* @SuppressLint is needed for new media3 APIs. */
public class MyActivity extends Activity {

  private static final String DEFAULT_STREAM_URL =
      "https://storage.googleapis.com/interactive-media-ads/media/bbb.m3u8";
  private static final String APP_LOG_TAG = "ImaDaiExample";
  private static final String PLAYER_TYPE = "DAISamplePlayer";
  private static ImaSdkSettings imaSdkSettings;

  protected SampleVideoPlayer sampleVideoPlayer;
  protected ImageButton playButton;

  private boolean contentHasStarted = false;

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

    View rootView = findViewById(R.id.videoLayout);
    sampleVideoPlayer =
        new SampleVideoPlayer(rootView.getContext(), rootView.findViewById(R.id.playerView));
    sampleVideoPlayer.enableControls(false);
    playButton = rootView.findViewById(R.id.playButton);
    final SampleAdsWrapper sampleAdsWrapper =
        new SampleAdsWrapper(this, sampleVideoPlayer, rootView.findViewById(R.id.adUiContainer));
    sampleAdsWrapper.setFallbackUrl(DEFAULT_STREAM_URL);

    final ScrollView scrollView = findViewById(R.id.logScroll);
    final TextView textView = findViewById(R.id.logText);

    sampleAdsWrapper.setLogger(
        logMessage -> {
          Log.i(APP_LOG_TAG, logMessage);
          if (textView != null) {
            textView.append(logMessage);
          }
          if (scrollView != null) {
            scrollView.post(() -> scrollView.fullScroll(View.FOCUS_DOWN));
          }
        });

    // Set up play button listener to play video then hide play button.
    playButton.setOnClickListener(
        view -> {
          if (contentHasStarted) {
            sampleVideoPlayer.play();
          } else {
            contentHasStarted = true;
            sampleVideoPlayer.enableControls(true);
            sampleAdsWrapper.requestAndPlayAds();
          }
          playButton.setVisibility(View.GONE);
        });
    orientVideoDescription(getResources().getConfiguration().orientation);
  }
MyActivity.java

ImaSdkSettings इंस्टेंस बनाने के लिए, getImaSdkSettings() हेल्पर मेथड जोड़ें.

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

लॉगिंग के लिए यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ने के लिए, गतिविधि की लेआउट फ़ाइल activity_my.xml में बदलाव करें.

<!-- UI element for viewing SDK event log -->
<ScrollView
    android:id="@+id/logScroll"
    android:layout_width="match_parent"
    android:layout_height="0dp"
    android:layout_weight="0.5"
    android:padding="5dp"
    android:background="#DDDDDD">

    <TextView
        android:id="@+id/logText"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
    </TextView>
</ScrollView>activity_my.xml

बधाई हो! अब आपके Android ऐप्लिकेशन में वीडियो विज्ञापनों का अनुरोध किया जा रहा है और उन्हें दिखाया जा रहा है. इसे बेहतर तरीके से लागू करने के लिए, बुकमार्क, स्नैपबैक, और एपीआई के दस्तावेज़ देखें.

समस्या का हल

अगर आपको वीडियो विज्ञापन चलाने में समस्या आ रही है, तो पूरा BasicExample डाउनलोड करके देखें. अगर यह BasicExample में ठीक से काम करता है, तो हो सकता है कि आपके ऐप्लिकेशन के IMA इंटिग्रेशन कोड में कोई समस्या हो.

अगर आपको अब भी समस्याएं आ रही हैं, तो IMA SDK फ़ोरम पर जाएं.