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

בחירת פלטפורמה: Android (גרסת בטא) חדש 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();
  }
}

Kotlin

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

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

כדי לטפל באירועים ספציפיים של סרטונים, צריך לכתוב מחלקה שמרחיבה את המחלקה המופשטת 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 + ".");
          }
        });
  }
}

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