类：AdEvent

google.ima.广告事件

class static

当广告状态变化以及用户与广告互动时，广告会通过引发该事件类型发出通知。例如，广告开始播放、用户点击广告等。您可以在 SurfaceFlinger 上注册各种状态更改事件。

Enumeration

类型

静态

字符串

AdEvents 的类型

值
AD_CAN_PLAY	在广告已准备好（无需缓冲）的情况下播放时（在广告开始时或缓冲完毕后）触发。
内容请求被暂停	在应该暂停内容时触发。这通常在广告即将覆盖内容之前发生。
请求获取内容	在内容应继续播放时触发。这通常在广告完成或合拢时发生。
CLICK	在用户点击广告时触发。
已点击视频	在用户点击视频广告的非点击部分时触发。
视频已点击	在用户点击视频图标时触发。
已开始	在广告开始播放时触发。
广告进度	在广告的当前时间值发生更改时触发。针对此事件调用 getAdData() 将返回 AdProgressData 对象。
广告加载	在广告停止播放到缓冲区时触发。
展示	在展示网址被 ping 后触发。
已暂停	在广告暂停时触发。
已恢复	在广告恢复时触发。
第 QUARTILE 篇	在广告的进度条指针已过第一个四分位时触发。
点	在广告的进度条指针已过中点时触发。
第三季度	在广告的进度条指针已过第三个四分位时触发。
完成	在广告播放完毕时触发。
DURATION_CHANGE	在广告的持续时间发生更改时触发。
用户关闭	在用户关闭广告时触发。
已加载	在有广告数据时触发。
所有广告已完成投放	在广告管理器播放完广告响应中的所有有效广告或者响应未返回任何有效广告时触发。
SKIPPED	在用户跳过广告时触发。
线性更改	在展示的广告从线性变为非线性（或反向）时触发。
SKIPPABLE_STATE_CHANGED	在显示的广告可跳过状态发生更改时触发。
广告元数据	在加载广告列表时触发。
AD_BREAK_READY	当 autoPlayAdBreaks 为 false 时，会在广告规则或 VMAP 广告插播时间点播放时触发。
LOG	遇到非严重错误时触发。用户无需执行任何操作，因为 SDK 会根据错误情况继续播放下一个或下一个广告。
成交量	在音量发生变化时触发。
成交量	在广告静音时触发。
互动	在广告触发互动回调时触发。 广告互动数据中包含互动 ID 字符串。

属性

类型

静态

字符串

AdEvents 的类型

值
AD_CAN_PLAY	在广告已准备好（无需缓冲）的情况下播放时（在广告开始时或缓冲完毕后）触发。
内容请求被暂停	在应该暂停内容时触发。这通常在广告即将覆盖内容之前发生。
请求获取内容	在内容应继续播放时触发。这通常在广告完成或合拢时发生。
CLICK	在用户点击广告时触发。
已点击视频	在用户点击视频广告的非点击部分时触发。
视频已点击	在用户点击视频图标时触发。
已开始	在广告开始播放时触发。
广告进度	在广告的当前时间值发生更改时触发。针对此事件调用 getAdData() 将返回 AdProgressData 对象。
广告加载	在广告停止播放到缓冲区时触发。
展示	在展示网址被 ping 后触发。
已暂停	在广告暂停时触发。
已恢复	在广告恢复时触发。
第 QUARTILE 篇	在广告的进度条指针已过第一个四分位时触发。
点	在广告的进度条指针已过中点时触发。
第三季度	在广告的进度条指针已过第三个四分位时触发。
完成	在广告播放完毕时触发。
DURATION_CHANGE	在广告的持续时间发生更改时触发。
用户关闭	在用户关闭广告时触发。
已加载	在有广告数据时触发。
所有广告已完成投放	在广告管理器播放完广告响应中的所有有效广告或者响应未返回任何有效广告时触发。
SKIPPED	在用户跳过广告时触发。
线性更改	在展示的广告从线性变为非线性（或反向）时触发。
SKIPPABLE_STATE_CHANGED	在显示的广告可跳过状态发生更改时触发。
广告元数据	在加载广告列表时触发。
AD_BREAK_READY	当 autoPlayAdBreaks 为 false 时，会在广告规则或 VMAP 广告插播时间点播放时触发。
LOG	遇到非严重错误时触发。用户无需执行任何操作，因为 SDK 会根据错误情况继续播放下一个或下一个广告。
成交量	在音量发生变化时触发。
成交量	在广告静音时触发。
互动	在广告触发互动回调时触发。 广告互动数据中包含互动 ID 字符串。

方法

getAd

getAd() 会返回广告

获取当前正在播放的广告或刚刚播放的广告。

返回

nullable Ad：与事件关联的广告；如果没有相关广告，则返回 null。

getAdData

getAdData() 返回对象

允许从广告传递额外数据。

示例：

if (event.type == google.ima.AdEvent.Type.LOG) {
  let adData = event.getAdData();
  if (adData['adError']) {
    console.log('Non-fatal error occurred: ' +
        adData['adError'].getMessage());
  }
}

返回

nullable Object：事件的额外数据。针对错误携带的类型为“google.ima.AdError”的对象（可通过“adError”键访问）引发的日志事件。