AppOpenAd

abstract class AppOpenAd

开屏广告用于在用户进入应用时展示广告。AppOpenAd 对象包含展示广告所需的所有数据。与插页式广告不同，开屏广告可轻松提供应用品牌宣传区域，以便用户了解看到广告时的情境。使用其中一种静态 load 方法加载 AppOpenAd。然后调用 show 以渲染该对象。

摘要

嵌套类型

用于接收开屏广告加载事件通知的对象。

公共构造函数

公共函数
abstract String

返回广告单元 ID。
abstract FullScreenContentCallback?

获取相应 AppOpenAd 的 FullScreenContentCallback。
abstract OnPaidEventListener?

获取相应 AppOpenAd 的 OnPaidEventListener。
abstract Long

获取相应 AppOpenAd 的展示位置 ID。
abstract ResponseInfo

返回已加载广告的 ResponseInfo。
java-static Boolean
isAdAvailable(context: Context, adUnitId: String)

此函数已弃用。

请改用 isAdAvailable。
java-static Unit
load(
    context: Context!,
    adUnitId: String!,
    adRequest: AdRequest!,
    loadCallback: AppOpenAd.AppOpenAdLoadCallback!
)

加载 AppOpenAd。
java-static AppOpenAd?
pollAd(context: Context, adUnitId: String)

此函数已弃用。

请改用 pollAd。
abstract Unit
setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
)

注册一个回调，以便在广告显示和关闭全屏内容时调用该回调。
abstract Unit
setImmersiveMode(immersiveModeEnabled: Boolean)

设置一个标志，用于控制此开屏广告对象是否以沉浸模式显示。
abstract Unit

注册一个回调，以便在此广告预计赚取收入时调用。
abstract Unit
setPlacementId(placementId: Long)

为开屏广告设置展示位置 ID。
abstract Unit
show(activity: Activity)

显示 AppOpenAd。

公共构造函数

AppOpenAd

AppOpenAd()

公共函数

getAdUnitId

abstract fun getAdUnitId(): String

返回广告单元 ID。

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

获取相应 AppOpenAd 的 FullScreenContentCallback。

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

获取相应 AppOpenAd 的 OnPaidEventListener。

getPlacementId

abstract fun getPlacementId(): Long

获取相应 AppOpenAd 的展示位置 ID。

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

返回已加载广告的 ResponseInfo。

isAdAvailable

java-static fun isAdAvailable(context: Context, adUnitId: String): Boolean

如果从 startPreload 加载了可用的应用开启广告，则返回 true。

负荷

java-static fun load(
    context: Context!,
    adUnitId: String!,
    adRequest: AdRequest!,
    loadCallback: AppOpenAd.AppOpenAdLoadCallback!
): Unit

加载 AppOpenAd。

参数
context: Context!

上下文。
adUnitId: String!

广告单元 ID。
adRequest: AdRequest!

包含定位信息的广告请求。
loadCallback: AppOpenAd.AppOpenAdLoadCallback!

用于处理开屏广告加载事件的对象。

pollAd

java-static fun pollAd(context: Context, adUnitId: String): AppOpenAd?

从 startPreload 中检索已加载的下一个开屏广告，如果没有广告可用，则检索 null。

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

注册一个回调，以便在广告显示和关闭全屏内容时调用该回调。

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

设置一个标志，用于控制此开屏广告对象是否以沉浸模式显示。在 show 之前调用此方法。在展示期间，如果此标志处于开启状态且支持沉浸模式，则系统会为应用开启广告启用 SYSTEM_UI_FLAG_IMMERSIVE_STICKY 和 SYSTEM_UI_FLAG_HIDE_NAVIGATION。

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

注册一个回调，以便在此广告预计赚取收入时调用。

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

为开屏广告设置展示位置 ID。

为确保此展示位置 ID 包含在报告中，请在展示广告之前调用此方法。

参数
placementId: Long

AdMob 界面为配置的展示位置提供的长整数。

显示

abstract fun show(activity: Activity): Unit

显示 AppOpenAd。

参数
activity: Activity

显示 AppOpenAd 的 activity。