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

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