若要讨论我们的产品并提供反馈，请加入 Google 广告和效果衡量社区服务器中的官方 AdMob Discord 频道。

此页面由 Cloud Translation API 翻译。

RewardedAdPreloader

Kotlin |Java

class RewardedAdPreloader

激励广告的预加载器。

摘要

公共函数
`java-static Boolean`	`destroy(preloadId: String!)` 停止为给定 `preloadId` 预加载，并销毁所有关联的预加载广告。
`java-static Unit`	`destroyAll()` 停止预加载并销毁所有预加载配置的预加载广告。
`java-static PreloadConfiguration?`	`getConfiguration(preloadId: String!)` 返回与此 `preloadId` 关联的激励广告 `PreloadConfiguration`；如果不存在，则返回 null。
`java-static (Mutable)Map<String!, PreloadConfiguration!>!`	`getConfigurations()` 返回所有激励广告 `PreloadConfiguration` 的映射，按关联的预加载 ID 键控。
`java-static Int`	`getNumAdsAvailable(preloadId: String!)` 返回给定预加载 ID 的可用广告数量。
`java-static Boolean`	`isAdAvailable(preloadId: String!)` 确定给定 `preloadId` 是否至少有 1 条广告可用。
`java-static RewardedAd?`	`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`。

java-static fun destroyAll(): Unit

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

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

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

参数
`preloadId: String!`	与此配置相关联的预加载 ID。

返回
`PreloadConfiguration?`	给定预加载 ID 的 `PreloadConfiguration`；如果给定预加载 ID 没有配置，则为 `null`。

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

返回所有激励广告 PreloadConfiguration 的映射，按关联的预加载 ID 键控。

返回
`(Mutable)Map<String!, PreloadConfiguration!>!`	激励广告配置；如果不存在预加载器，则返回空映射。

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

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

参数
`preloadId: String!`	用于检查可用性的预加载 ID。

返回
`Int`	给定预加载 ID 的可用广告数量。

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

确定给定 preloadId 是否至少有 1 条广告可用。

参数
`preloadId: String!`	用于检查可用性的预加载 ID。

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

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

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

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

参数
`preloadId: String!`	广告的预加载 ID。

返回
`RewardedAd?`	指定预加载 ID 的激励广告，如果没有可用的广告，则为 `null`。

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`。

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

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

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

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

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

参数
`preloadId: String!`	用于唯一标识此 `PreloadConfiguration` 的字符串。调用 `pollAd` 时，请使用此标识符检索此配置的预加载广告。
`preloadConfiguration: PreloadConfiguration!`	用于指定广告预加载方式的配置。
`preloadCallback: PreloadCallbackV2!`	在给定 `PreloadConfiguration` 的广告可用性发生变化时要调用的回调。

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