AppOpenAdPreloader

Kotlin |Java

class AppOpenAdPreloader

---

أداة التحميل المُسبَق للإعلانات على شاشة فتح التطبيق

ملخّص

الوظائف العامة
java-static Boolean	destroy(preloadId: String!) يوقف التحميل المُسبَق لـ preloadId المحدّد ويزيل جميع الإعلانات المحمَّلة مُسبقًا والمرتبطة به.
java-static Unit	destroyAll() توقف التحميل المُسبَق وتتلف الإعلانات التي تم تحميلها مُسبقًا لجميع إعدادات التحميل المُسبَق.
java-static PreloadConfiguration?	getConfiguration(preloadId: String!) تعرض هذه السمة الإعلان على شاشة فتح التطبيق PreloadConfiguration المرتبط بهذا preloadId، أو تعرض القيمة null إذا لم يكن هناك إعلان.
java-static (Mutable)Map<String!, PreloadConfiguration!>!	getConfigurations() تعرِض هذه الطريقة خريطة لجميع PreloadConfigurationإعلانات التطبيق المفتوح، مع تحديد مفاتيحها حسب رقم تعريف التحميل المُسبَق المرتبط بها.
java-static Int	getNumAdsAvailable(preloadId: String!) تعرض هذه الدالة عدد الإعلانات المتاحة لرقم التعريف المحدّد للتحميل المُسبَق.
java-static Boolean	isAdAvailable(preloadId: String!) تحدّد ما إذا كان هناك إعلان واحد على الأقل متاح preloadId المحدّد.
java-static AppOpenAd?	pollAd(preloadId: String!) تعرض هذه الطريقة إعلانًا تم تحميله مسبقًا من start أو start وتزيله من ذاكرة التخزين المؤقت.
java-static Boolean	start(preloadId: String!, preloadConfiguration: PreloadConfiguration!) يبدأ التحميل المُسبَق للإعلانات في preloadId وPreloadConfiguration المحدّدتَين.
java-static Boolean	start(     preloadId: String!,     preloadConfiguration: PreloadConfiguration!,     preloadCallback: PreloadCallbackV2! ) يبدأ في التحميل المُسبَق للإعلانات الخاصة بـ preloadId وPreloadConfiguration وPreloadCallbackV2 المحدّدة.

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

إتلافه

java-static fun destroy(preloadId: String!): Boolean

يوقف التحميل المُسبَق لـ preloadId المحدّد ويزيل جميع الإعلانات المحمَّلة مُسبقًا والمرتبطة به.

المعلمات
preloadId: String!	معرّف التحميل المُسبق للإعدادات المطلوب إيقافها

المرتجعات
Boolean	‫true إذا تم إيقاف إعدادات التحميل المُسبَق النشطة. تعرض هذه السمة القيمة false إذا لم يكن هناك إعداد مسبق نشط للتحميل المسبق لـ preloadId المحدّد.

destroyAll

java-static fun destroyAll(): Unit

توقف التحميل المُسبَق وتتلف الإعلانات التي تم تحميلها مُسبقًا لجميع إعدادات التحميل المُسبَق.

getConfiguration

java-static fun getConfiguration(preloadId: String!): PreloadConfiguration?

تعرض هذه السمة الإعلان على شاشة فتح التطبيق PreloadConfiguration المرتبط بهذا preloadId، أو تعرض القيمة null إذا لم يكن هناك إعلان.

المعلمات
preloadId: String!	معرّف التحميل المُسبَق المرتبط بهذا الإعداد

المرتجعات
PreloadConfiguration?	تعرض هذه السمة PreloadConfiguration لمعرّف التحميل المُسبَق المحدّد، أو null إذا لم يكن هناك إعدادات لمعرّف التحميل المُسبَق المحدّد.

getConfigurations

java-static fun getConfigurations(): (Mutable)Map<String!, PreloadConfiguration!>!

تعرِض هذه الطريقة خريطة لجميع PreloadConfigurationإعلانات التطبيق المفتوح، مع تحديد مفاتيحها حسب رقم تعريف التحميل المُسبَق المرتبط بها.

المرتجعات
(Mutable)Map<String!, PreloadConfiguration!>!	إعدادات "الإعلانات على شاشة فتح التطبيق"، أو خريطة فارغة في حال عدم توفّر أي أدوات تحميل مسبق.

getNumAdsAvailable

java-static fun getNumAdsAvailable(preloadId: String!): Int

تعرض هذه الدالة عدد الإعلانات المتاحة لرقم التعريف المحدّد للتحميل المُسبَق.

المعلمات
preloadId: String!	معرّف التحميل المُسبَق للتحقّق من مدى توفّره.

المرتجعات
Int	عدد الإعلانات المتاحة لمعرّف التحميل المُسبَق المحدّد.

isAdAvailable

java-static fun isAdAvailable(preloadId: String!): Boolean

تحدّد ما إذا كان هناك إعلان واحد على الأقل متاح preloadId المحدّد.

المعلمات
preloadId: String!	معرّف التحميل المُسبَق للتحقّق من مدى توفّره.

المرتجعات
Boolean	‫true إذا كان هناك إعلان متاح لرقم التعريف المحدّد للتحميل المُسبَق، أو false في حال عدم توفّره.

pollAd

java-static fun pollAd(preloadId: String!): AppOpenAd?

تعرض هذه الطريقة إعلانًا تم تحميله مسبقًا من start أو start وتزيله من ذاكرة التخزين المؤقت.

يُرجى العِلم أنّ هذا قد يكون أيًا من الإعلانات التي تم تحميلها مسبقًا لـ preloadId. لا نضمن أن يتطابق الترتيب الذي يتم عرضه مع ترتيب أحداث onAdPreloaded.

المعلمات
preloadId: String!	معرّف التحميل المُسبَق للإعلان.

المرتجعات
AppOpenAd?	إعلان عند فتح التطبيق لمعرّف التحميل المُسبَق المحدّد، أو null إذا لم يتوفّر أي إعلان

بدء

java-static fun start(preloadId: String!, preloadConfiguration: PreloadConfiguration!): Boolean

يبدأ التحميل المُسبَق للإعلانات في preloadId وPreloadConfiguration المحدّدتَين.

تواصل حزمة تطوير البرامج (SDK) التحميل المُسبَق للإعلانات إلى أن يتم الوصول إلى عدد الإعلانات المحدّد بواسطة getBufferSize، محاولةً إبقاء المخزن المؤقت ممتلئًا طوال الجلسة.

إذا سبق أن بدأ PreloadConfiguration باستخدام preloadId، ستصبح هذه الطريقة غير صالحة وستعرض false.

المعلمات
preloadId: String!	تمثّل هذه السمة معرّف سلسلة PreloadConfiguration. استخدِم هذا المعرّف عند طلب pollAd للحصول على إعلان لهذه الإعدادات.
preloadConfiguration: PreloadConfiguration!	إعدادات التحميل المُسبَق للإعلانات

المرتجعات
Boolean	‫true إذا بدأت عملية التحميل المُسبَق، false إذا كان preloadId قيد الاستخدام.

بدء

java-static fun start(
    preloadId: String!,
    preloadConfiguration: PreloadConfiguration!,
    preloadCallback: PreloadCallbackV2!
): Boolean

يبدأ في التحميل المُسبَق للإعلانات الخاصة بـ preloadId وPreloadConfiguration وPreloadCallbackV2 المحدّدة.

تواصل حزمة تطوير البرامج (SDK) التحميل المُسبَق للإعلانات إلى أن يتم الوصول إلى عدد الإعلانات المحدّد بواسطة getBufferSize، محاولةً إبقاء المخزن المؤقت ممتلئًا طوال الجلسة.

لكل طلب إعلان، تُفعّل حزمة تطوير البرامج (SDK) إما عملية ردّ الاتصال onAdPreloaded عند التحميل المُسبَق بنجاح أو عملية ردّ الاتصال onAdFailedToPreload في حال تعذُّر التحميل المُسبَق. تعيد حزمة تطوير البرامج (SDK) تلقائيًا محاولة تنفيذ الطلبات التي تعذّر إجراؤها.

إذا سبق أن بدأت PreloadConfiguration باستخدام preloadId المحدّدة، لن ينفّذ هذا الإجراء أي شيء وسيعرض false. تصبح عملية غير نشطة وتعرض القيمة false.

المعلمات
preloadId: String!	سلسلة تحدّد هذا PreloadConfiguration بشكل فريد. استخدِم هذا المعرّف عند طلب pollAd لاسترداد إعلان تم تحميله مسبقًا لهذا الإعداد.
preloadConfiguration: PreloadConfiguration!	الإعداد الذي يحدّد طريقة التحميل المُسبَق للإعلانات.
preloadCallback: PreloadCallbackV2!	دالّة ردّ اتصال يتم استدعاؤها عند تغيُّر مدى توفّر الإعلان PreloadConfiguration المحدّد.

المرتجعات
Boolean	‫true إذا بدأت عملية التحميل المُسبَق، false إذا كان preloadId قيد الاستخدام.