google.
用于指定广告请求属性的类。
构造函数
AdsRequest
新的 AdsRequest()
- 实现
- google.ima.AdsRequestInterface
属性
adTagUrl
string
指定从广告服务器请求的广告代码网址。 如需详细了解如何构建广告代码网址，请参阅 手动创建主视频广告代码。
此参数是必需的。
adsResponse
（null、字符串或非 null 文档）
指定用作广告响应的 VAST 2.0 文档（而不是通过广告代码网址发出请求）。这对于调试以及存在 VAST 响应的其他情况非常有用。
此参数是可选参数。
contentDuration
（null 或数字）
指定要显示的内容的时长（以秒为单位）。它适用于以下两种情况：1) AdX 广告定位和 2) 决定何时预加载 VMAP 后贴片广告。
此参数是可选参数。
contentKeyword
（字符串数组或非 null 数组）
指定用于描述要显示的内容的关键字。在 AdX 请求中使用。
此参数是可选的。
contentTitle
（null 或字符串）
指定要显示的内容的标题。在 AdX 请求中使用。
此参数是可选参数。
forceNonLinearFullSlot
boolean
强制将非线性 AdSense 广告呈现为线性全幅广告。如果设置此标记，系统会暂停内容视频，并将非线性广告或图片广告呈现为全幅广告。广告跳过或关闭后，内容视频便会继续播放。
linearAdSlotHeight
number
指定展示线性广告的矩形区域的高度。该值可用作广告选择标准之一。 此值无需与实际广告的高度一致。
此参数是必需的。
LinearAdSlotWidth
number
指定展示线性广告的矩形区域的宽度。该值可用作广告选择标准之一。 此值无需与实际广告的宽度相匹配。
此参数是必需的。
liveStreamPrefetchSeconds
number
指定请求 requestAds 后、请求广告代码网址前等待的最长时间（以秒为单位）。这可用于在直播活动期间交错请求，以减少请求次数激增。
NonLinearAdSlotHeight
number
指定展示非线性广告的矩形区域的高度。该值可用作广告选择标准之一。此值无需与实际广告的高度一致。
此参数是必需的。
NonLinearAdSlotWidth
number
指定展示非线性广告的矩形区域的宽度。该值可用作广告选择标准之一。此值无需与实际广告的宽度相匹配。
此参数是必需的。
omidAccessModeRules
具有字符串属性的非 null 对象
用于将验证供应商映射到 OMID 访问模式的设置对象。 键必须是 google.ima.OmidVerificationVendor 中的值，并且值必须是 google.ima.OmidAccessMode 中的值。
验证脚本网址会在内部与供应商提供的正则表达式匹配，以解析为 OmidVerificationVendor 密钥。然后，IMA 会使用此对象查找指定供应商的访问模式。
如果脚本网址无法解析为已知的供应商，或者在此对象中未提供已解析的 OmidVerificationVendor，IMA 将会使用为 OmidVerificationVendor 提供的访问模式。OTHER. 如果未提供 OmidVerificationVendor.OTHER，则系统会使用 LIMITED 访问模式。
pageUrl
（null 或字符串）
指定要添加到 Google 广告请求中以用于定位的网页的完整网址。该网址需要是有效的网址。如果指定了此值，此值将用于 [PAGE网址] VAST 宏。
此参数是可选参数。
vastLoadTimeout
number
替换单个封装容器的默认 VAST 加载超时（以毫秒为单位）。默认的超时时间为 5000 毫秒。
此参数是可选的。
方法
setAdWillAutoPlay
setAdWillAutoPlay(autoPlay) returns void
向 SDK 通知玩家是打算启动内容还是响应用户操作，或者是否会自动播放。 更改此设置不会影响广告播放。
参数 |
|
|---|---|
|
自动播放 |
boolean 内容和广告是否自动播放，或者是否由用户操作启动。 |
- 返回
-
void
setAdWillPlayMuted
setAdWillPlayMuted(muted) return void
通知 SDK 播放器是否打算在静音时开始展示广告。更改此设置不会影响广告播放，但会在广告请求中发送适当的信号，以允许买方对静音广告资源出价。
参数 |
|
|---|---|
|
已设为静音 |
boolean 广告是否静音播放。 |
- 返回
-
void
setContinuousPlayback
setContinuousPlayback(continuePlayback) returns void
通知 SDK 播放器是否打算连续播放内容视频（类似于电视广播）。更改此设置不会影响广告播放，但会在此请求中发送适当的信号，让买方对广告资源类型出价。
参数 |
|
|---|---|
|
连续播放 |
boolean 内容视频是否接连播放。 |
- 返回
-
void