替换视频流参数是一项可选的操作。
如果您想让播放器或应用替换以下内容,则可执行此操作:
- 视频流创建参数的默认值
- 请求 HLS 或 DASH 播放列表时所选或默认的变体顺序。
对于 IMA SDK、服务器端信标 (SSB) 和 DAI API 实现,您都可从播放器或应用中传递这些参数。
替换所选变体和变体顺序
默认的播放列表顺序由发布商决定。如果您未指定任何排序参数,系统便会按照发布商设置的原始顺序返回播放列表。
您可以替换在创建视频流的过程中指定的变体选项和排序参数。这样一来,您便可指定在响应主播放列表请求时要包含哪一部分变体以及这些变体采用何种顺序。如果您想根据内容观看者的具体情况让某个特定变体优先于另一个变体,替换视频流变体参数可能会非常有用。
这部分变体及其顺序在相应视频流的整个播放期内将保持不变。这些参数可通过以下形式被接受:作为 adTagParameters 结构的一部分(使用 IMA SDK、DAI API 参数时),或作为额外的 HTTP GET
参数(使用 SSB 时)。
参数 | 流式传输协议 | 说明 | 示例 |
---|---|---|---|
dai-aor |
HLS、DASH |
要返回的音频变体的带宽范围。
|
|
dai-dlid |
HLS、DASH |
为视频素材资源创建 CDN 配置时,请指定默认的 CDN 配置以及额外的 CDN 分发设置。这样一来,您便可设置多个 CDN 并在会话开始时使用键值对动态地选择希望从哪个 CDN 分发内容。 在您设置并保存 CDN 配置后,Ad Manager 会为每个配置分配一个名称。此名称应以 如果未向相应请求传递任何名称,则 Ad Manager 会使用默认的 CDN。 注意:如果单项内容有多个 CDN 且有多个分发位置,则 |
( |
dai-excl |
HLS、DASH | 要从播放列表中排除的转译版本。支持 subtitles 、codec 、audio-lang 、subtitle-lang 、iframe 和 resolution 。您可使用单个值或一系列以英文逗号分隔的值来排除分辨率、音频编解码器、视频编解码器以及音频和/或字幕语言。系统还支持带有后缀“*”的 Codec 前缀,这会排除带有指定前缀的 codec 的所有转义版本。 |
一个编解码器 多个编解码器 编解码器前缀 一种音频语言 一种字幕语言 多项选择 分辨率 |
dai-os |
HLS | 要放置在主播放列表顶部的视频变体带宽。系统会选择与 startBandwidth 值最接近的变体。如果有两个值与此值同等接近,系统会选择最低值。如果提供了此参数,而未提供 dai-aor ,系统将排除所有仅限音频的变体。 |
dai-os=1700000 |
dai-ot |
HLS |
这是顺序类型信息,用于描述 如果指定了 |
dai-ot=bw dai-ot=bw_res |
dai-ov |
HLS |
这是一系列以英文逗号分隔的值,用于指定要返回的媒体播放列表的顺序。必须和 如果多个变体具有相同的顺序值(例如,带宽相同但分辨率不同的两个变体),这些变体会保持原始顺序。 |
|
dai-sr |
HLS、DASH |
要返回的视频变体的带宽范围。若要选择所有较高带宽,请仅指定 带宽强制执行仅适用于视频内容。
|
dai-sr=1300000:2500000 |
其他可替换参数
参数 | 流式传输协议 | 说明 | 示例 |
---|---|---|---|
dai-ah |
HLS、DASH | 指定某个直播活动是否应该应用暂停显示广告。必须在直播活动配置中指定暂停显示广告的时长。 | 启用“暂停显示广告”:dai-ah=1 |
dai-apto (Beta 版) |
HLS、DASH |
广告连播决策超时时限(以毫秒为单位),用于限制 VOD 和直播活动创建。 此值用于在创建视频流时做出的所有“屏蔽广告”相关决策,包括线性直播的中间广告插播决策和既往广告插播决策,以及 VOD 的 VMAP 决策。对于既往的广告插播时间点,这一时限仅在使用 EVENT 类型的播放列表或 dai-dpb 参数时可用。 这一时限可设为任何大于 0 且不大于 10,000 的值。
将这一时限设为非常低/高的值可能会影响广告填充或用户体验。 |
dai-apto=4000 |
dai-dpb |
HLS、DASH |
指定是否要为非 SSB 线性视频流启用既往广告插播决策(对于 SSB 视频流,此参数会被忽略)。如果启用,既往广告插播决策会与中间广告插播决策一同制定。 这可能会影响启动延迟时间,您可以使用 既往广告插播不会被用户看到,除非用户回放,而这可能会导致代码调用次数增多。 |
启用“既往广告插播决策”:dai-dpb=true 为 HLS EVENT 类型的播放列表停用“既往广告插播决策”: dai-dpb=false |
dai-dvr |
HLS、DASH | 用户可以向回滚动并保持播放流畅的直播内容和广告的 DVR 时长(以秒为单位)。
此时长的当前默认值是 100 秒,或是在直播活动设置期间指定的值。不过,您可为每个直播活动指定一个新的上限(对于 SSB,最长可以指定 100 秒;如果使用 SDK 或 API,最长可以指定 1800 秒)。如果您需要更长的 DVR 时长,请与您的客户经理联系。 |
dai-dvr=60 |
dai-emsgv |
HLS |
Event Message 版本是一个视频流创建参数,允许调用方为 Common Media Application Format (CMAF) 内容指定“emsg”版本。 HLS 标准要求使用“emsg”版本 1。 对于不支持标准版本 1 且需要版本 0 的平台(例如 Roku),此设置非常有用。
|
dai-emsgv=1 |
dai-pre (Beta 版) |
HLS、DASH | 指定启用了前贴片广告的直播活动是否应在前贴片广告和中贴片广告重叠的情况下展示前贴片广告,而不展示中贴片广告。默认行为是展示重叠部分的中贴片广告,而不展示前贴片广告。 | dai-pre=1 |
dai-ad-dlid (Beta 版) |
HLS、DASH |
为您已在 Google Ad Manager 中预配置的外部 CDN 指定与众不同的名称,以便向直播活动投放广告。 详细了解如何通过外部 CDN 投放广告。 |
( |
dai-aup (Beta 版) |
HLS、DASH |
指定一个指向外部 CDN 的任意网址前缀,用于构建广告片段网址,以便向直播活动投放广告。 详细了解如何通过外部 CDN 投放广告。 |
dai-aup=https://domain.com/path-c1/path-c2 |