מודעות וידאו מותאמות

MediaContent

מודעות מותאמות ופורמטים מותאמים אישית של מודעות מותאמות מספקים גישה לאובייקט MediaContent, שמשמשים לאיסוף מידע על תוכן מדיה, למשל וידאו או תמונה. הוא משמש גם לצורך בקרה על ההפעלה של מודעות הווידאו ולהאזנה לאירועי הפעלה. אפשר לקבל את האובייקט MediaContent באמצעות קריאה ל-NativeAd.getMediaContent().

האובייקט MediaContent מכיל מידע כמו יחס גובה-רוחב ומשך הסרטון. קטע הקוד הבא מראה איך לקבל את יחס הגובה-רוחב ואת משך הזמן של מודעה רגילה.

Java

if (myNativeAd.getMediaContent().hasVideoContent()) {
  float mediaAspectRatio = myNativeAd.getMediaContent().getAspectRatio();
  float duration = myNativeAd.getMediaContent().getDuration();
  ...
}

Kotlin

if (myNativeAd.getMediaContent().hasVideoContent()) {
  val mediaAspectRatio: Float = myNativeAd.getMediaContent().getAspectRatio()
  val duration: Float = myNativeAd.getMediaContent().getDuration()
  ...
}

קריאות חוזרות (callbacks) לאירועי וידאו

כדי לטפל באירועי וידאו ספציפיים, כותבים כיתה שמרחיבה את הכיתה המופשטת VideoLifecycleCallbacks ומפעילים את setVideoLifecycleCallbacks() על VideoController. לאחר מכן, משנים רק את קריאות ה-back-call שחשובות לכם.

Java

myNativeAd.getMediaContent().getVideoController()
        .setVideoLifecycleCallbacks(new VideoLifecycleCallbacks() {

  /** Called when video playback first begins. */
  @Override
  public void onVideoStart() {
    // Do something when the video starts the first time.
    Log.d("MyApp", "Video Started");
  }

  /** Called when video playback is playing. */
  @Override
  public void onVideoPlay() {
    // Do something when the video plays.
    Log.d("MyApp", "Video Played");
  }

  /** Called when video playback is paused. */
  @Override
  public void onVideoPause() {
    // Do something when the video pauses.
    Log.d("MyApp", "Video Paused");
  }

  /** Called when video playback finishes playing. */
  @Override
  public void onVideoEnd() {
    // Do something when the video ends.
    Log.d("MyApp", "Video Ended");
  }

  /** Called when the video changes mute state. */
  @Override
  public void onVideoMute(boolean isMuted) {
    // Do something when the video is muted.
    Log.d("MyApp", "Video Muted");
  }
});

Kotlin

myNativeAd.getMediaContent().getVideoController().setVideoLifecycleCallbacks {

  /** Called when video playback first begins. */
  override fun onVideoStart() {
    // Do something when the video starts the first time.
    Log.d("MyApp", "Video Started")
  }

  /** Called when video playback is playing. */
  override fun onVideoPlay() {
    // Do something when the video plays.
    Log.d("MyApp", "Video Played")
  }

  /** Called when video playback is paused. */
  override fun onVideoPause() {
    // Do something when the video pauses.
    Log.d("MyApp", "Video Paused")
  }

  /** Called when video playback finishes playing. */
  override fun onVideoEnd() {
    // Do something when the video ends.
    Log.d("MyApp", "Video Ended")
  }

  /** Called when the video changes mute state. */
  override fun onVideoMute(boolean isMuted) {
    // Do something when the video is muted.
    Log.d("MyApp", "Video Muted")
  }
}