CustomEventInterstitial

Kotlin |Java

public interface CustomEventInterstitial extends CustomEvent

---

تم إيقاف هذه الواجهة نهائيًا.

استخدِم Adapter بدلاً من ذلك.

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

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

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

ملخّص

الطرق العامة
abstract void	requestInterstitialAd(     Context context,     CustomEventInterstitialListener listener,     @Nullable String serverParameter,     MediationAdRequest mediationAdRequest,     @Nullable Bundle customEventExtras ) يتمّ استدعاؤه من مكتبة التوسّط لطلب إعلان بيني.
abstract void	showInterstitial() اعرض الإعلان البيني.

الطرق المكتسَبة
من com.google.android.gms.ads.mediation.customevent.CustomEvent abstract void onDestroy() تمّت إزالة وحدة التحكّم في المحوِّل. abstract void onPause() يتم استدعاؤه عندما يتصل التطبيق بـ pause. abstract void onResume() يتم استدعاؤه عندما يتصل التطبيق بـ resume.

الطرق العامة

requestInterstitialAd

abstract void requestInterstitialAd(
    Context context,
    CustomEventInterstitialListener listener,
    @Nullable String serverParameter,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle customEventExtras
)

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

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

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

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

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

showInterstitial

abstract void showInterstitial()

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