إعلانات الفيديو المدمجة مع المحتوى

اختيار النظام الأساسي: Android iOS

MediaContent

توفّر الإعلانات المدمجة مع المحتوى إمكانية الوصول إلى عنصر MediaContent يُستخدَم للحصول على معلومات حول محتوى الوسائط، والذي يمكن أن يكون فيديو أو صورة. ويُستخدم أيضًا للتحكّم في تشغيل إعلانات الفيديو والاستماع إلى أحداث التشغيل. يمكنك الحصول على العنصر MediaContent من خلال استدعاء NativeAd.getMediaContent().

يحتوي العنصر MediaContent على معلومات مثل نسبة العرض إلى الارتفاع ومدة الفيديو. يوضّح المقتطف التالي كيفية الحصول على نسبة العرض إلى الارتفاع ومدة الإعلان الأصلي.

Kotlin

if (myNativeAd.mediaContent.hasVideoContent) {
  val mediaAspectRatio: Float = myNativeAd.mediaContent.aspectRatio
  val duration: Float = myNativeAd.mediaContent.duration
  // ...
}

Java

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

عمليات ردّ الاتصال لأحداث الفيديو

للتعامل مع أحداث فيديو معيّنة، اكتب فئة توسّع الفئة المجردة VideoLifecycleCallbacks، واستدعِ setVideoLifecycleCallbacks() على VideoController. بعد ذلك، يمكنك تجاهل عمليات معاودة الاتصال التي تهمّك فقط.

Kotlin

val videoController = myNativeAd.mediaContent.videoController
videoController.videoLifecycleCallbacks = object : VideoController.VideoLifecycleCallbacks {
  override fun onVideoStart() {
    Log.d("MyApp", "Video Started")
  }

  override fun onVideoPlay() {
    Log.d("MyApp", "Video Played")
  }

  override fun onVideoPause() {
    Log.d("MyApp", "Video Paused")
  }

  override fun onVideoEnd() {
    Log.d("MyApp", "Video Ended")
  }

  override fun onVideoMute(boolean isMuted) {
    Log.d("MyApp", "Video Muted")
  }
}

Java

VideoController videoController = myNativeAd.getMediaContent().getVideoController();
videoController.setVideoLifecycleCallbacks(new VideoLifecycleCallbacks() {
  @Override
  public void onVideoStart() {
    Log.d("MyApp", "Video Started");
  }

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

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

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

  @Override
  public void onVideoMute(boolean isMuted) {
    Log.d("MyApp", "Video Muted");
  }
});