CustomEventBanner

Kotlin |Java

interface CustomEventBanner : CustomEvent

حدث مخصّص لدعم "إعلانات البانر"

تتمثّل دورة الحياة النموذجية لحدث مخصّص في استدعاء requestBannerAd مرة واحدة. في هذه المرحلة، من المفترض أن ينشئ المحوّل android.view.View ويُبلغ CustomEventBannerListener إما onAdLoaded أو onAdFailedToLoad. سيتمّ تقديم الطلبات اللاحقة باستخدام مثيل جديد للحدث المخصّص. في نهاية دورة الحياة، يتم بذل أقصى جهد للاتصال بـ onDestroy، ولكن لا يمكن ضمان ذلك. يُرجى العِلم أنّه يتم استدعاء requestBannerAd في سلسلة التعليمات الخاصة بواجهة المستخدم، لذا تنطبق جميع احتياطات كتابة الرمز البرمجي في سلسلة التعليمات هذه. وعلى وجه الخصوص، يجب ألا يستدعي الرمز أي طرق حظر.

من المتوقّع أن يعرض المحوّل الأحداث من خلال CustomEventBannerListener التي تم تمريرها في طلب requestBannerAd. يجب تمرير جميع المَعلمات اللازمة لتقديم طلب إعلان في المَعلمات serverParameter وMediationAdRequest وcustomEventExtras.

ملخّص

الوظائف العامة
`Unit`	`requestBannerAd( context: Context!, listener: CustomEventBannerListener!, serverParameter: String?, size: AdSize!, mediationAdRequest: MediationAdRequest!, customEventExtras: Bundle? )` يتم استدعاؤها من خلال مكتبة التوسّط لطلب عرض من الحدث المخصّص.

الدوال الموروثة

من com.google.android.gms.ads.mediation.customevent.CustomEvent

`Unit`	`onDestroy()` تفكيك وحدة التحكّم في محوّل الطاقة
`Unit`	`onPause()` يتم استدعاء هذه الطريقة عندما يستدعي التطبيق `pause`.
`Unit`	`onResume()` يتم استدعاء هذه الطريقة عندما يستدعي التطبيق `resume`.

الوظائف العامة

requestBannerAd

fun requestBannerAd(
    context: Context!,
    listener: CustomEventBannerListener!,
    serverParameter: String?,
    size: AdSize!,
    mediationAdRequest: MediationAdRequest!,
    customEventExtras: Bundle?
): Unit

يتم استدعاؤها من خلال مكتبة التوسّط لطلب عرض من الحدث المخصّص.

في حال نجاح الطلب، يجب استدعاء onAdLoaded.

في حال عدم نجاح الطلب، يجب استدعاء onAdFailedToLoad على listener مع تحديد سبب مناسب للخطأ.

يتم استدعاء هذه الطريقة في سلسلة التعليمات الرئيسية لواجهة المستخدم، لذا تنطبق جميع احتياطات كتابة الرمز البرمجي في سلسلة التعليمات هذه. على وجه الخصوص، يجب ألا يستدعي الرمز أي طرق حظر.

المعلمات
`context: Context!`	`Context` الخاص بـ AdView الذي سيحتوي على الحدث المخصّص `android.view.View` يُفضَّل استخدام `android.app.Activity`.
`listener: CustomEventBannerListener!`	متتبّع الأحداث المخصّصة مع عمليات استدعاء لأحداث مختلفة
`serverParameter: String?`	السلسلة التي تمّ ضبطها في واجهة مستخدم الناشر كمَعلمة للحدث المخصّص.
`size: AdSize!`	حجم العرض المطلوب جلبه. يجب أن يكون حجم العرض قريبًا قدر الإمكان من الحجم المحدّد في هذه المَعلمة. إذا كان حجم طريقة العرض هذا غير متاح، يجب أن يفشل الطلب ويجب استدعاء onAdFailedToLoad.
`mediationAdRequest: MediationAdRequest!`	مَعلمات الاستهداف العامة التي يجب استخدامها عند طلب عرض.
`customEventExtras: Bundle?`	`Bundle` من المَعلمات التي يضبطها الناشر على أساس كل طلب على حدة