CustomEventInterstitial

Kotlin |Java

interface CustomEventInterstitial : CustomEvent

حدث مخصّص يتيح الإعلانات البينية

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

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

ملخّص

الوظائف العامة
`Unit`	`requestInterstitialAd( context: Context!, listener: CustomEventInterstitialListener!, serverParameter: String?, mediationAdRequest: MediationAdRequest!, customEventExtras: Bundle? )` يتمّ استدعاؤه من مكتبة التوسّط لطلب إعلان بيني.
`Unit`	`showInterstitial()` اعرض الإعلان البيني.

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

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

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

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

requestInterstitialAd

fun requestInterstitialAd(
    context: Context!,
    listener: CustomEventInterstitialListener!,
    serverParameter: String?,
    mediationAdRequest: MediationAdRequest!,
    customEventExtras: Bundle?
): Unit

يتمّ استدعاؤه من مكتبة التوسّط لطلب إعلان بيني.

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

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

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

المعلمات
`context: Context!`	`Context` من التي طلبت البطاقة البينية للحدث المخصّص. يُفضّل استخدام `android.app.Activity`.
`listener: CustomEventInterstitialListener!`	مستمع للحدث المخصّص مع عمليات استدعاء لأحداث مختلفة
`serverParameter: String?`	السلسلة التي تم ضبطها في واجهة مستخدم الناشر كمَعلمة للحدث المخصّص.
`mediationAdRequest: MediationAdRequest!`	مَعلمات الاستهداف العامة التي يجب استخدامها عند طلب إعلان بيني
`customEventExtras: Bundle?`	`Bundle` من المَعلمات التي يحدّدها الناشر على أساس كل طلب

showInterstitial

fun showInterstitial(): Unit

اعرض الإعلان البيني. يمكن استدعاء هذه الوظيفة في أي وقت بعد إجراء مكالمة إلى onAdLoaded.