MediationBannerAdapter

Kotlin |Java

interface MediationBannerAdapter : MediationAdapter

محوِّل لشبكات المواقع الإعلانية التابعة لجهات خارجية التي تتيح إعلانات البانر

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

من المتوقّع أن يعرِض المُحوِّل الأحداث من خلال MediationBannerListener الذي تم تمريره في طلب requestBannerAd. يجب تمرير جميع المَعلمات اللازمة لتقديم طلب إعلان في المَعلمات serverParameters وMediationAdRequest وmediationExtras.

على موفّري أدوات الربط بذل جهد لإيقاف إعادة تحميل الإعلانات التلقائية من جهة العميل. قد يتم تجاهل الإعلانات التي تتم إعادة تحميلها أو عدم عرضها أو احتسابها بشكل غير صحيح.

ملخّص

الوظائف العامة
`View!`	`getBannerView()` تعرِض هذه السمة `View` الذي يمكن عرضه لعرض الإعلان.
`Unit`	`requestBannerAd( context: Context!, listener: MediationBannerListener!, serverParameters: Bundle!, adSize: AdSize!, mediationAdRequest: MediationAdRequest!, mediationExtras: Bundle? )` يتمّ استدعاء هذه الوظيفة من قِبل مكتبة التوسّط لطلب إعلان بانر من المحوِّل.

الدوال المُكتسَبة

من com.google.android.gms.ads.mediation.MediationAdapter

`Unit`	`onDestroy()` تمّت إزالة وحدة التحكّم في المحوِّل.
`Unit`	`onPause()` يتم استدعاؤه عندما يستدعي التطبيق `onPause` على
`Unit`	`onResume()` يتم استدعاؤه عندما يستدعي التطبيق `onResume` على

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

getBannerView

fun getBannerView(): View!

تعرِض هذه السمة View الذي يمكن عرضه لعرض الإعلان.

يجب ألا يكون هذا الحقل فارغًا بعد طلب requestBannerAd وقبل طلب onDestroy. وقد يكون فارغًا في أي وقت آخر.

requestBannerAd

fun requestBannerAd(
    context: Context!,
    listener: MediationBannerListener!,
    serverParameters: Bundle!,
    adSize: AdSize!,
    mediationAdRequest: MediationAdRequest!,
    mediationExtras: Bundle?
): Unit

يتمّ استدعاء هذه الوظيفة من قِبل مكتبة التوسّط لطلب إعلان بانر من المحوِّل.

إذا كان الطلب ناجحًا، يجب استدعاء الأسلوب onAdLoaded.

إذا تعذّر الطلب، يجب استدعاء الطريقة onAdFailedToLoad في listener مع سبب خطأ مناسب.

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

المعلمات
`context: Context!`	`Context` لعرض الإعلان الذي سيحتوي على عرض البانر. يُفضّل استخدام
`listener: MediationBannerListener!`	مستمع إلى المُحوِّل مع عمليات ردّ اتصال لأحداث مختلفة
`serverParameters: Bundle!`	مَعلمات إضافية يحدّدها الناشر من جهة خادم التوسّط
`adSize: AdSize!`	حجم الإعلان الذي تريد استرجاعه. يجب أن يكون حجم الإعلان الذي يتم إرجاعه أقرب ما يمكن إلى الحجم المحدّد في هذه المَعلمة. إذا كان حجم الإعلان هذا غير متوافق، من المفترض أن يفشل الطلب وأن يتمّ استدعاء onAdFailedToLoad.
`mediationAdRequest: MediationAdRequest!`	مَعلمات عامة يمكن لهذا الناشر استخدامها عند تقديم طلب الإعلان
`mediationExtras: Bundle?`	مَعلمات إضافية يحدّدها الناشر لكل طلب على حدة