الرد على أحداث الفيديو

اختيار النظام الأساسي: Android (إصدار تجريبي) جديد Android iOS

MediaContent

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

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

جافا

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. بعد ذلك، عليك إلغاء طرق ردّ الاتصال التي تهمّك فقط.

جافا

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