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

此页面由 Cloud Translation API 翻译。

InterstitialAdPreloader

Kotlin |Java

public final class InterstitialAdPreloader

插页式广告的预加载器。

摘要

公共方法
`static boolean`	`destroy(String preloadId)` 停止预加载给定的 `preloadId`，并销毁所有关联的预加载广告。
`static void`	`destroyAll()` 停止预加载并销毁所有预加载配置的预加载广告。
`static @Nullable PreloadConfiguration`	`getConfiguration(String preloadId)` 此方法已弃用。无替代项。
`static Map<String, PreloadConfiguration>`	`getConfigurations()` 此方法已弃用。无替代项。
`static int`	`getNumAdsAvailable(String preloadId)` 返回指定预加载 ID 的可用广告数量。
`static boolean`	`isAdAvailable(String preloadId)` 确定指定 `preloadId` 是否至少有一个广告可用。
`static @Nullable InterstitialAd`	`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` 和的广告。

public static boolean destroy(String preloadId)

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

参数
`String preloadId`	要销毁的配置的预加载 ID。

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

public static void destroyAll()

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

public static @Nullable PreloadConfiguration getConfiguration(String preloadId)

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

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

返回
`@Nullable PreloadConfiguration`	指定预加载 ID 的 `PreloadConfiguration`，如果没有指定预加载 ID 的配置，则为 `null`。

public static Map<String, PreloadConfiguration> getConfigurations()

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

返回
`Map<String, PreloadConfiguration>`	插页式广告配置，如果没有预加载器，则为空映射。

public static int getNumAdsAvailable(String preloadId)

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

参数
`String preloadId`	要检查的预加载 ID。

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

public static boolean isAdAvailable(String preloadId)

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

参数
`String preloadId`	要检查的预加载 ID。

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

public static @Nullable InterstitialAd pollAd(String preloadId)

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

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

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

返回
`@Nullable InterstitialAd`	指定预加载 ID 的插页式广告，如果没有可用的广告，则为 `null`。

public static boolean start(String preloadId, PreloadConfiguration preloadConfiguration)

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

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

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

参数
`String preloadId`	相应 `PreloadConfiguration` 的字符串标识符。在调用 `pollAd` 以获取此配置的广告时，请使用此标识符。
`PreloadConfiguration preloadConfiguration`	预加载广告的配置。

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

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

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

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

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

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

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

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