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

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()
  ...
}

طلبات معاودة الاتصال لأحداث الفيديو

للتعامل مع أحداث فيديو معينة، اكتب صفًا يوسّع الملخّص صف واحد (VideoLifecycleCallbacks) والاتصال setVideoLifecycleCallbacks() في VideoController. وبعد ذلك، يمكنك إلغاء عمليات معاودة الاتصال التي تهمّك فقط.

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