این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

AppOpenAdPreloader

کاتلین | جاوا

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` های باز برنامه را که با شناسه‌ی preload مرتبط با آنها کلیدگذاری شده‌اند، برمی‌گرداند.
`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` برمی‌گرداند. اگر هیچ پیکربندی پیش‌بارگذاری فعالی برای `preloadId` داده شده وجود نداشته باشد، مقدار `false` را برمی‌گرداند.

نابود کن همه

java-static fun destroyAll(): Unit

پیش‌بارگذاری را متوقف می‌کند و تبلیغات از پیش بارگذاری شده را برای همه پیکربندی‌های پیش‌بارگذاری از بین می‌برد.

دریافت پیکربندی

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

مقدار PreloadConfiguration مربوط به این preloadId را برمی‌گرداند، یا در صورت عدم وجود، null را برمی‌گرداند.

پارامترها
`preloadId: String !`	شناسه‌ی پیش‌بارگذاری مرتبط با این پیکربندی.

بازگشت‌ها
`PreloadConfiguration ?`	`PreloadConfiguration` برای شناسه‌ی پیش‌بارگذاری داده شده، یا اگر هیچ پیکربندی برای شناسه‌ی پیش‌بارگذاری داده شده وجود نداشته باشد، `null` .

دریافت پیکربندی‌ها

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

نقشه‌ای از تمام PreloadConfiguration های باز برنامه را که با شناسه‌ی preload مرتبط با آنها کلیدگذاری شده‌اند، برمی‌گرداند.

بازگشت‌ها
`( Mutable ) Map < String !, PreloadConfiguration !>!`	تنظیمات تبلیغات باز برنامه، یا اگر هیچ پیش‌بارگذار وجود نداشته باشد، یک نقشه خالی.

getNumAdsAvailable

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

تعداد تبلیغات موجود برای شناسه‌ی پیش‌بارگذاری داده شده را برمی‌گرداند.

پارامترها
`preloadId: String !`	شناسه‌ی پیش‌بارگذاری برای بررسی در دسترس بودن.

بازگشت‌ها
`Int`	تعداد تبلیغات موجود برای شناسه‌ی پیش‌بارگذاری داده شده.

موجود است

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

تعیین می‌کند که آیا حداقل یک تبلیغ برای preloadId داده شده در دسترس است یا خیر.

پارامترها
`preloadId: String !`	شناسه‌ی پیش‌بارگذاری برای بررسی در دسترس بودن.

بازگشت‌ها
`Boolean`	اگر تبلیغی برای شناسه‌ی پیش‌بارگذاری داده شده موجود باشد، `true` و در غیر این صورت `false` برمی‌گرداند.

نظرسنجی

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 شروع شده باشد، این متد به یک no-op تبدیل می‌شود و false را برمی‌گرداند.

پارامترها
`preloadId: String !`	یک شناسه رشته‌ای برای این `PreloadConfiguration` . از این شناسه هنگام فراخوانی pollAd برای دریافت تبلیغ برای این پیکربندی استفاده کنید..
`preloadConfiguration: PreloadConfiguration !`	پیکربندی برای پیش بارگذاری تبلیغات.

بازگشت‌ها
`Boolean`	اگر پیش‌بارگذاری شروع شده باشد، `true` و اگر preloadId در حال استفاده باشد، `false` .

شروع

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

پیش‌بارگذاری تبلیغات را برای preloadId ، PreloadConfiguration و PreloadCallbackV2 داده شده شروع می‌کند.

برای هر درخواست تبلیغ، SDK یا در صورت پیش‌بارگذاری موفقیت‌آمیز، فراخوانی onAdPreloaded را فعال می‌کند یا در صورت عدم موفقیت پیش‌بارگذاری، فراخوانی onAdFailedToPreload را اجرا می‌کند. SDK به‌طور خودکار درخواست‌های ناموفق را دوباره امتحان می‌کند.

اگر یک PreloadConfiguration از قبل با preloadId داده شده شروع شده باشد، این متد هیچ کاری انجام نمی‌دهد و false را برمی‌گرداند. به no-op تبدیل می‌شود و false را برمی‌گرداند.

پارامترها
`preloadId: String !`	رشته‌ای که به طور منحصر به فرد این `PreloadConfiguration` مشخص می‌کند. هنگام فراخوانی `pollAd` برای بازیابی یک تبلیغ از پیش بارگذاری شده برای این پیکربندی، از این شناسه استفاده کنید.
`preloadConfiguration: PreloadConfiguration !`	پیکربندی که نحوه‌ی پیش‌بارگذاری تبلیغات را تعیین می‌کند.
`preloadCallback: PreloadCallbackV2 !`	یک فراخوانی برگشتی که هنگام تغییر در دسترس بودن تبلیغات برای `PreloadConfiguration` داده شده، فراخوانی می‌شود.

بازگشت‌ها
`Boolean`	اگر پیش‌بارگذاری شروع شده باشد، `true` و اگر preloadId در حال استفاده باشد، `false` .