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

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. לאחר מכן, משנים רק את קריאות החזרה (callbacks) שחשובות לכם.

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")
  }
}