المتطلبات الأساسية
GADMediaContent
توفّر الإعلانات المدمجة إمكانية الوصول إلى فئة GADMediaContent
التي تُستخدَم للحصول على
معلومات عن محتوى الوسائط الذي يمكن أن يكون فيديو أو صورة. ويُستخدَم أيضًا
للتحكّم في تشغيل إعلان الفيديو من خلال الاستماع إلى أحداث التشغيل. يمكنك الوصول إلى
عنصر محتوى الوسائط من خلال سمة .mediaContent
في الإعلان.
يحتوي العنصر
GADMediaContent
على معلومات، مثل نسبة العرض إلى الارتفاع ومدّة الفيديو. يوضّح المقتطف أدناه كيفية الحصول على نسبة العرض إلى الارتفاع ومدة إعلان مضمّن.
Swift
if myNativeAd.mediaContent.hasVideoContent { let mediaAspectRatio = CGFloat(myNativeAd.mediaContent.aspectRatio) let duration = myNativeAd.mediaContent.duration ... }
Objective-C
if(myNativeAd.mediaContent.hasVideoContent) { CGFloat mediaAspectRatio = myNativeAd.mediaContent.aspectRatio; NSTimeInterval duration = myNativeAd.mediaContent.duration; ... }
GADVideoController
يحتوي عنصر GADMediaContent
على مرجع إلى عنصر
GADVideoController
. يتيح عنصر GADVideoController
للناشرين الردّ على أحداث
الفيديوهات.
يمكن أيضًا التحكّم في الإعلانات التي يتم عرضها من خلال عناصر الإعلان باستخدام GADVideoController
.
يمكن الحصول على عنصر GADVideoController
هذا من خلال استدعاء
GADMediaContent.videoController
.
عمليات معاودة الاتصال لأحداث الفيديو
لمعالجة أحداث فيديو معيّنة، عليك كتابة فئة تنفِّذ بروتوكول
GADVideoControllerDelegate
. جميع طرق البروتوكول اختيارية.
يوضّح المثال التالي كيفية تنفيذ بروتوكول المفوّض:
Swift
class ViewController: GADNativeAdLoaderDelegate, GADVideoControllerDelegate { private var adLoader: GADAdLoader? func viewDidLoad() { super.viewDidLoad() let videoOptions = GADVideoOptions() videoOptions.customControlsRequested = true adLoader = GADAdLoader( adUnitID: "ca-app-pub-3940256099942544/3986624511", rootViewController: self, adTypes: [GADAdLoaderAdTypeNative], options: [videoOptions]) adLoader?.delegate = self adLoader?.load(GADRequest()) } func adLoader( _ adLoader: GADAdLoader?, didReceive nativeAd: GADNativeAd? ) { // Set the videoController's delegate to be notified of video events. nativeAd?.mediaContent.videoController.delegate = self } // GADVideoControllerDelegate methods func videoControllerDidPlayVideo(_ videoController: GADVideoController) { // Implement this method to receive a notification when the video controller // begins playing the ad. } func videoControllerDidPauseVideo(_ videoController: GADVideoController) { // Implement this method to receive a notification when the video controller // pauses the ad. } func videoControllerDidEndVideoPlayback(_ videoController: GADVideoController) { // Implement this method to receive a notification when the video controller // stops playing the ad. } func videoControllerDidMuteVideo(_ videoController: GADVideoController) { // Implement this method to receive a notification when the video controller // mutes the ad. } func videoControllerDidUnmuteVideo(_ videoController: GADVideoController) { // Implement this method to receive a notification when the video controller // unmutes the ad. } }
Objective-C
@interface ViewController () <GADNativeAdLoaderDelegate, GADVideoControllerDelegate> @property(nonatomic, strong) GADAdLoader *adLoader; @end @implementation ViewController - (void)viewDidLoad { [super viewDidLoad]; GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init]; videoOptions.customControlsRequested = YES; self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511" rootViewController:self adTypes:@[ GADAdLoaderAdTypeNative ] options:@[ videoOptions ]]; self.adLoader.delegate = self; [self.adLoader loadRequest:[GAMRequest request]]; } - (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd { // Set the videoController's delegate to be notified of video events. nativeAd.mediaContent.videoController.delegate = self; } // GADVideoControllerDelegate methods - (void)videoControllerDidPlayVideo:(nonnull GADVideoController *)videoController { // Implement this method to receive a notification when the video controller // begins playing the ad. } - (void)videoControllerDidPauseVideo:(nonnull GADVideoController *)videoController { // Implement this method to receive a notification when the video controller // pauses the ad. } - (void)videoControllerDidEndVideoPlayback:(nonnull GADVideoController *)videoController { // Implement this method to receive a notification when the video controller // stops playing the ad. } - (void)videoControllerDidMuteVideo:(nonnull GADVideoController *)videoController { // Implement this method to receive a notification when the video controller // mutes the ad. } - (void)videoControllerDidUnmuteVideo:(nonnull GADVideoController *)videoController { // Implement this method to receive a notification when the video controller // unmutes the ad. } @end
اطّلِع على سياسات وإرشادات الإعلانات المدمجة مع المحتوى للحصول على مزيد من الإرشادات حول كيفية عرض إعلاناتك المدمجة مع المحتوى.