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

הפלטפורמה: Android iOS

MediaContent

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

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

Java

if (nativeAd.getMediaContent() != null) {
  MediaContent mediaContent = nativeAd.getMediaContent();
  float mediaAspectRatio = mediaContent.getAspectRatio();
  if (mediaContent.hasVideoContent()) {
    float duration = mediaContent.getDuration();
  }
}
NativeVideoAdsSnippets.java

Kotlin

nativeAd.mediaContent?.let { mediaContent ->
  val mediaAspectRatio: Float = mediaContent.aspectRatio
  if (mediaContent.hasVideoContent()) {
    val duration: Float = mediaContent.duration
  }
}
NativeVideoAdsSnippets.kt

התקשרות חוזרת לאירועים של סרטונים

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

Java

if (nativeAd.getMediaContent() != null) {
  VideoController videoController = nativeAd.getMediaContent().getVideoController();
  if (videoController != null) {
    videoController.setVideoLifecycleCallbacks(
        new VideoController.VideoLifecycleCallbacks() {
          @Override
          public void onVideoStart() {
            Log.d(TAG, "Video started.");
          }

          @Override
          public void onVideoPlay() {
            Log.d(TAG, "Video played.");
          }

          @Override
          public void onVideoPause() {
            Log.d(TAG, "Video paused.");
          }

          @Override
          public void onVideoEnd() {
            Log.d(TAG, "Video ended.");
          }

          @Override
          public void onVideoMute(boolean isMuted) {
            Log.d(TAG, "Video isMuted: " + isMuted + ".");
          }
        });
  }
}
NativeVideoAdsSnippets.java

Kotlin

val videoLifecycleCallbacks =
  object : VideoController.VideoLifecycleCallbacks() {
    override fun onVideoStart() {
      Log.d(TAG, "Video started.")
    }

    override fun onVideoPlay() {
      Log.d(TAG, "Video played.")
    }

    override fun onVideoPause() {
      Log.d(TAG, "Video paused.")
    }

    override fun onVideoEnd() {
      Log.d(TAG, "Video ended.")
    }

    override fun onVideoMute(isMuted: Boolean) {
      Log.d(TAG, "Video isMuted: $isMuted.")
    }
  }
nativeAd.mediaContent?.videoController?.videoLifecycleCallbacks = videoLifecycleCallbacks
NativeVideoAdsSnippets.kt