InterstitialAdPreloader

class InterstitialAdPreloader

插页式广告的预加载器。

摘要

公共函数
java-static Boolean
destroy(preloadId: String!)

停止预加载给定的 preloadId，并销毁所有关联的预加载广告。
java-static Unit

停止预加载并销毁所有预加载配置的预加载广告。
java-static PreloadConfiguration?
getConfiguration(preloadId: String!)

此函数已弃用。

无替代项。
java-static (Mutable)Map<String!, PreloadConfiguration!>!

此函数已弃用。

无替代项。
java-static Int

返回指定预加载 ID 的可用广告数量。
java-static Boolean
isAdAvailable(preloadId: String!)

确定指定 preloadId 是否至少有一个广告可用。
java-static InterstitialAd?
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 和 的广告。

公共函数

销毁

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

停止预加载给定的 preloadId，并销毁所有关联的预加载广告。

参数
preloadId: String!

要销毁的配置的预加载 ID。
返回
Boolean

true 如果活跃的预加载配置被销毁。如果指定 preloadId 没有有效的预加载配置，则返回 false。

destroyAll

java-static fun destroyAll(): Unit

停止预加载并销毁所有预加载配置的预加载广告。

getConfiguration

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

返回与此 preloadId 关联的插页式广告 PreloadConfiguration；如果不存在，则返回 null。

参数
preloadId: String!

与此配置相关联的预加载 ID。
返回
PreloadConfiguration?

指定预加载 ID 的 PreloadConfiguration，如果没有指定预加载 ID 的配置，则为 null。

getConfigurations

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

返回所有插页式广告 PreloadConfiguration 的映射，以其关联的预加载 ID 为键。

返回
(Mutable)Map<String!, PreloadConfiguration!>!

插页式广告配置，如果没有预加载器，则为空映射。

getNumAdsAvailable

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

返回指定预加载 ID 的可用广告数量。

参数
preloadId: String!

要检查的预加载 ID。
返回
Int

指定预加载 ID 对应的可用广告数量。

isAdAvailable

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

确定指定 preloadId 是否至少有一个广告可用。

参数
preloadId: String!

要检查的预加载 ID。
返回
Boolean

如果指定预加载 ID 有可用的广告，则为 true；否则为 false。

pollAd

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

返回从 start 或 start 预加载的广告，并将其从缓存中移除。

请注意，这可能是为 preloadId 预加载的任何广告。返回的顺序不一定与 onAdPreloaded 事件的顺序一致。

参数
preloadId: String!

广告的预加载 ID。
返回
InterstitialAd?

指定预加载 ID 的插页式广告，如果没有可用的广告，则为 null。

start

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

开始预加载指定 preloadId 和 PreloadConfiguration 的广告。

SDK 会继续预加载广告，直到达到 getBufferSize 指定的广告数量，并尝试在整个会话期间保持缓冲区满载。

如果已使用 preloadId 启动 PreloadConfiguration，此方法将变为无操作并返回 false。

参数
preloadId: String!

相应 PreloadConfiguration 的字符串标识符。在调用 pollAd 以获取此配置的广告时，请使用此标识符。
preloadConfiguration: PreloadConfiguration!

预加载广告的配置。
返回
Boolean

如果预加载已开始，则返回 true；如果 preloadId 正在使用，则返回 false。

start

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

开始预加载指定 preloadId、PreloadConfiguration 和 的广告。

SDK 会继续预加载广告，直到达到 getBufferSize 指定的广告数量，并尝试在整个会话期间保持缓冲区满载。

对于每个广告请求，如果预加载成功，SDK 会触发 onAdPreloaded 回调；如果预加载失败，则会触发 onAdFailedToPreload 回调。SDK 会自动重试失败的请求。

如果已使用给定的 preloadId 启动 PreloadConfiguration，此方法不会执行任何操作并返回 false。变为无操作并返回 false。

参数
preloadId: String!

唯一标识相应 PreloadConfiguration 的字符串。在调用 pollAd 以检索此配置的预加载广告时，请使用此标识符。
preloadConfiguration: PreloadConfiguration!

用于指定广告预加载方式的配置。
preloadCallback: PreloadCallbackV2!

当指定 PreloadConfiguration 的广告可用性发生变化时要调用的回调。
返回
Boolean

如果预加载已开始，则返回 true；如果 preloadId 正在使用，则返回 false。