پاسخ دادن به رویدادهای ویدیو

انتخاب پلاتفرم: Android iOS Android (قدیمی)

MediaContent

آگهی‌های بومی و قالب‌های آگهی بومی سفارشی دسترسی به MediaContent شیئی را فراهم می‌کنند که برای دریافت اطلاعات درباره محتوای رسانه‌ای استفاده می‌شود، که می‌تواند ویدیو یا تصویر باشد. همچنین برای کنترل بازپخش آگهی ویدیویی و گوش دادن به رویدادهای بازپخش استفاده می‌شود. با فراخواندن NativeAd.getMediaContent() می‌توانید شیء MediaContent را دریافت کنید.

شیء MediaContent حاوی اطلاعاتی مانند نسبت ابعادی و مدت زمان ویدیو است. تکه کد زیر نشان می‌دهد که چگونه نسبت ابعادی و مدت زمان آگهی بومی را دریافت کنید.

جاوا

if (nativeAd.getMediaContent() != null) {
  MediaContent mediaContent = nativeAd.getMediaContent();
  float mediaAspectRatio = mediaContent.getAspectRatio();
  if (mediaContent.hasVideoContent()) {
    float duration = mediaContent.getDuration();
  }
}
NativeVideoAdsSnippets.java

Kotlin

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

بازخوان‌ها برای رویدادهای ویدیویی

برای مدیریت رویدادهای ویدیویی خاص، کلاسی بنویسید که کلاس انتزاعی 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 + ".");
          }
        });
  }
}
NativeVideoAdsSnippets.java

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
NativeVideoAdsSnippets.kt