MediaContent
توفّر الإعلانات المدمجة مع المحتوى إمكانية الوصول إلى عنصرMediaContent
يُستخدَم للحصول على معلومات حول محتوى الوسائط، والذي يمكن أن يكون فيديو أو صورة. ويُستخدم أيضًا للتحكّم في تشغيل إعلانات الفيديو والاستماع إلى أحداث التشغيل. يمكنك الحصول على العنصر MediaContent
من خلال استدعاء NativeAd.getMediaContent()
.
يحتوي العنصر MediaContent
على معلومات مثل نسبة العرض إلى الارتفاع ومدة الفيديو. يوضّح المقتطف التالي كيفية الحصول على نسبة العرض إلى الارتفاع ومدة عرض إعلان أصلي.
Java
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
. بعد ذلك، يمكنك تجاهل عمليات معاودة الاتصال التي تهمّك فقط.
Java
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