google. ima. AdPodInfo
广告可能属于广告连播。此对象公开了与该广告连播相关的元数据,例如广告连播中的广告数量以及其中的广告位置。
此对象中包含的 getTotalAds
API 通常正确无误,但在某些情况下,它代表 SDK 的最佳猜测。如需了解详情,请参阅该方法的文档。
方法
getAdPosition
getAdPosition() 会返回数字
返回广告的位置。
- 返回
-
number
广告在广告连播内的位置。返回的值从 1 开始,例如 1/2、2/2 等。
getIsBumper
getIsBumper() 会返回布尔值
如果广告为导视广告,则返回 true。导视广告是一种简短的线性广告,可在用户进入或退出广告插播时间点时向用户指明。
- 返回
-
boolean
广告是否为导视广告。
getMaxDuration
getMaxDuration() 会返回数字
广告连播的时长上限(以秒为单位)。对于未知时长,返回 -1。
- 返回
-
number
此广告连播中的广告的时长上限(以秒为单位)。
getPodIndex
getPodIndex() 会返回数字
客户端和 DAI VOD:返回广告连播的索引。对于前贴片广告 Pod,则返回 0。对于中贴片广告,系统将返回 1、2、...、北对于后贴片广告连播,则返回 -1。如果此广告不是广告连播的一部分,或不属于广告连播,则默认为 0。DAI 直播:始终返回 -1。
- 返回
-
number
:广告播放列表中广告连播的索引。
getTimeOffset
getTimeOffset() 会返回数字
返回为当前广告连播安排的内容时间偏移。 对于包含动态插入广告的 VOD 视频流中的广告连播,系统会返回视频流时间。
对于前贴片广告连播,系统会返回 0。对于中贴片广告,系统会返回预定时间。对于后贴片广告,则返回 -1。
如果此广告不属于广告连播,或者该广告连播不属于广告播放列表,则默认为 0。
- 返回
-
number
:当前广告连播的时间偏移。
getTotalAds
getTotalAds() 会返回数字
此广告连播内包含的广告总数(包括导视广告)。 导视广告是一种简短的线性广告,可在用户进入或退出广告插播时间点时向用户指明。
如果广告不是广告连播的一部分,则默认为 1。
在某些情况下,SDK 无法确定这个广告连播内包含多少个广告。这些场景包括广告连播,即单个广告代码中的多个广告。在此类情况下,前几个 AdEvent 触发的事件(AD_METADATA、LOADED 等)可能仅包含来自播放列表响应的广告代码总数。我们建议将 FIRST_QUARTILE 事件用作事件,让事件从该对象中提取信息并更新播放器的视觉元素(如果有)。
- 返回
-
number
广告连播中的广告总数。