AppOpenAdPreloader

Kotlin |Java

public final class AppOpenAdPreloader

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

ملخّص

الإجراءات العامة
`static boolean`	`destroy(String preloadId)` يوقف التحميل المُسبَق لـ `preloadId` المحدّد ويزيل جميع الإعلانات المحمَّلة مُسبقًا والمرتبطة به.
`static void`	`destroyAll()` توقف التحميل المُسبَق وتتلف الإعلانات التي تم تحميلها مُسبقًا لجميع إعدادات التحميل المُسبَق.
`static @Nullable PreloadConfiguration`	`getConfiguration(String preloadId)` تعرض هذه السمة الإعلان على شاشة فتح التطبيق `PreloadConfiguration` المرتبط بهذا `preloadId`، أو تعرض القيمة null إذا لم يكن هناك إعلان.
`static Map<String, PreloadConfiguration>`	`getConfigurations()` تعرِض هذه الطريقة خريطة لجميع `PreloadConfiguration`إعلانات التطبيق المفتوح، مع تحديد مفاتيحها حسب رقم تعريف التحميل المُسبَق المرتبط بها.
`static int`	`getNumAdsAvailable(String preloadId)` تعرض هذه الدالة عدد الإعلانات المتاحة لرقم التعريف المحدّد للتحميل المُسبَق.
`static boolean`	`isAdAvailable(String preloadId)` تحدّد ما إذا كان هناك إعلان واحد على الأقل متاح `preloadId` المحدّد.
`static @Nullable AppOpenAd`	`pollAd(String preloadId)` تعرض هذه الطريقة إعلانًا تم تحميله مسبقًا من `start` أو `start` وتزيله من ذاكرة التخزين المؤقت.
`static boolean`	`start(String preloadId, PreloadConfiguration preloadConfiguration)` يبدأ التحميل المُسبَق للإعلانات في `preloadId` و`PreloadConfiguration` المحدّدتَين.
`static boolean`	`start( String preloadId, PreloadConfiguration preloadConfiguration, PreloadCallbackV2 preloadCallback )` يبدأ في التحميل المُسبَق للإعلانات الخاصة بـ `preloadId` و`PreloadConfiguration` و`PreloadCallbackV2` المحدّدة.

الإجراءات العامة

إتلافه

public static boolean destroy(String preloadId)

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

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

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

destroyAll

public static void destroyAll()

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

getConfiguration

public static @Nullable PreloadConfiguration getConfiguration(String preloadId)

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

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

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

getConfigurations

public static Map<String, PreloadConfiguration> getConfigurations()

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

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

getNumAdsAvailable

public static int getNumAdsAvailable(String preloadId)

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

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

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

isAdAvailable

public static boolean isAdAvailable(String preloadId)

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

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

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

pollAd

public static @Nullable AppOpenAd pollAd(String preloadId)

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

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

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

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

بدء

public static boolean start(String preloadId, PreloadConfiguration preloadConfiguration)

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

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

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

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

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

بدء

public static boolean start(
    String preloadId,
    PreloadConfiguration preloadConfiguration,
    PreloadCallbackV2 preloadCallback
)

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

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

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

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

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