as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
Vega支持三种广告插入技术,由播放器管理内容到广告的切换(与服务器端广告插入相反,后者将广告拼接到流中)。这些技术在谁做出广告决策方面有所不同 — 是应用、清单标记处的客户端,还是预先由服务器决定:
  • CSAI — 带外: 应用使用外部时间表(而非清单标记)来确定何时插入广告。应用会获取VAST/VMAP并播放广告素材。
  • CSAI — 带内边界标记: 清单会指示广告时段应出现的位置,但不会指示要播放的内容。客户端检测到标记并获取VAST以解析广告。
  • SGAI — 服务器引导: 清单中包含可播放的广告URL。服务器已决定要播放的内容;播放器会直接获取并播放。
在以上三种情况下,内容流均未修改,播放器负责处理内容播放与广告播放之间的切换,切换可在单个共享展示位上进行,也可在主内容和广告各自的独立展示位上进行。

广告插入技术

CSAI — 带外(标准)

在标准CSAI中,客户端应用依靠外部信息,而不是清单标签来确定何时插入广告。播放器接收未经修改的内容清单并单独处理广告逻辑。 广告时机来自清单之外。来源包括:
  • VMAP: 播放器获取一个外部XML文件,该文件在特定时间戳(例如,在0秒、300秒)安排广告时段。
  • 硬编码逻辑: 应用程序根据播放器当前的时间位置以固定的间隔触发广告请求(例如,每20秒一次)。
  • 边车文件: 该应用从内容管理系统 (CMS) 下载单独的配置文件 (JSON/XML),该文件列出了特定内容的广告中断时间。
  • 广告SDK: SDK(如Google Interactive Media Ads)通过广告规则在内部管理时间,从而无需开发者管理特定的时间戳或清单标签。
流: 应用确定广告时段 → 获取VAST → 播放广告素材。 在典型的带外实现中,广告标记是在用户界面层中定义的(例如,硬编码或从节目表中获取),位置侦听器直接触发插入。不会向服务层发送任何广告信息。

CSAI — 带内边界标记(高级)

在高级CSAI中,清单包含标记,指示“此处为广告时段”— 但不包含广告URL。客户端必须决定播放什么。 常见的边界标记包括: 当播放器遇到边界标记(例如#EXT-X-CUE-OUT)时,它会将其解释为广告利用机会,并在指定的持续时间内向广告服务器发起VAST或VMAP请求。在主要内容继续播放的同时,会同时提取和缓冲广告内容。仅当达到广告展示时间时,主要内容才会暂停。届时,预计该广告可以开始播放,以提供无缝体验。 流: 解析清单 → 检测边界 → 客户端获取VAST → 解析 → 播放广告素材。 在使用无头方法的带内实现中,用户界面可以通过sendMessage({type: 'adList', ads})将广告列表发送到服务层,以提供与清单解析所生成数据相同的数据。该服务将广告列表存储在PlayerSession上,并在getCurrentPlaybackPosition()过程中处理广告标记。当达到广告的预缓冲窗口时(startTime前5秒),该服务会向用户界面发送{type: 'adMarkers', ad}消息,然后触发广告插入。

SGAI — 服务器引导的广告插入

在服务器引导的广告插入 (SGAI) 中,清单包含标记,指示“播放此URL”— 广告URL已存在。服务器已决定要播放的内容;播放器在解析清单时发现广告,从嵌入的URL获取广告素材并播放。 SGAI标记包括: 与CSAI不同,无需进行VAST解析或使用广告SDK。播放器解析清单以发现广告URL,获取广告媒体,暂停内容,播放广告流,然后恢复内容。播放器还会在存在X-RESTRICT(跳过/跳转限制)和CUE(前贴片/后贴片行为)属性时强制执行这些属性。 流: 解析清单 → 提取广告URL → 获取并播放(无VAST,无广告SDK)。 与CSAI的主要区别:
  • 应用不提供广告标签URL — 清单本身就是广告时间表。
  • 无需解析VAST/VMAP — URL直接指向可播放的.m3u8或.mpd媒体。
  • 服务器预先决定要投放哪个广告。无法进行实时客户端个性化。
  • 清单可在CDN处缓存(不像SSAI那样按观看者进行个性化)。
SGAI非常适合直播和VOD内容中的前贴片和中插片插入,此类场景下内容提供商在打包时控制广告选择。

展示位模式

所有三种广告插入技术都采用双播放器架构: 主播放器用于内容,广告播放器用于广告。两个播放器可以共享一个视频展示位,也可以各自拥有独立的展示位。

单展示位(共享)

主播放器和广告播放器共用同一个KeplerVideoSurfaceView。主播放器必须在广告播放器渲染展示位前将其释放:
  • JS方法: 在主播放器上调用clearSurfaceHandle(surfaceHandle),然后在广告播放器上调用setSurfaceHandle(surfaceHandle)。
  • 无头方法: 在主播放器会话上调用clearVideoView(sessionId),然后在广告播放器会话上调用setVideoView(surfaceHandle, sessionId)。
广告结束后,广告播放器会释放展示位,主播放器会在内容恢复前再次设置该展示位。

双展示位

每个播放器都有自己专属的KeplerVideoSurfaceView。广告位通过zIndex定位,叠加在主内容区域之上。广告播放时,主播放器无需释放其展示位,广告结束时也无需再次设置。

展示位视图布局 (JSX)

主内容展示位使用zIndex: 1,广告展示位使用zIndex: 2,因此广告会在顶层渲染:
无广告播放时,广告位呈透明色,会显示主内容。广告播放器渲染的帧会覆盖底下的主内容。

处理不同宽高比的广告(双展示位)

当广告和主内容的宽高比相同(例如均为16:9)时,广告位会直接叠加主内容。无需额外处理。 当两者的宽高比不同时,由于尺寸不匹配,非活动表面会在活动表面后方透出来。为避免此问题,可使用屏幕外渲染,将非活动展示位移到屏幕外:
要实现这一点,请添加状态变量const [adSurfaceVisible, setAdSurfaceVisible] = useState(false),并在广告开始时将其切换为true,在广告结束时切换为false。

播放同步策略

所有三种广告插入技术都支持两种策略,用于在过渡期间协调主播放器和广告播放器。展示位步骤因您使用共享展示位还是双展示位而有所不同。

预缓冲广告(无缝)

广告播放器在过渡之前会预先初始化并缓冲。这提供了没有视觉干扰的无缝用户体验。
  1. 主要内容播放。
  2. 检测到广告标记。使用autoPlay=false预初始化广告播放器。
  3. 广告播放器缓冲区。canplay事件触发 (JS) 或服务发送READY状态(无头)。
  4. 用户界面收到就绪信号。广告已准备好播放,等待预定的播放时间。
  5. 位置侦听器会检测到已达到广告开始时间。暂停主要内容。
  6. 主要内容已暂停。切换到广告并开始播放:
    • 共享展示位: 清除主展示位,在广告播放器上设置同一展示位,然后播放广告。
    • 双展示位: 在广告播放器上设置广告展示位并播放广告。不要清除主展示位。
  7. 广告结束。清理广告展示位,清理广告播放器,然后恢复主要内容:
    • 共享展示位: 恢复之前再次在主播放器上设置主展示位。
    • 双展示位: 恢复主内容。主展示位从未被清除,因此无需再次设置。
特征:
  • 没有视觉干扰
  • 播放前对广告内容进行预缓冲
  • 最适合优质观看体验
  • autoPlay设置:false(手动控制)

即时自动播放广告(有间隔)

广告中断发生时,将按需初始化广告播放器。由于广告在播放时使用autoPlay=true加载,因此在广告播放器初始化期间可能会有短暂的过渡间隔。
  1. 主要内容播放。
  2. 检测到广告标记。暂停主要内容。
  3. 主要内容已暂停。使用autoPlay=true初始化广告播放器:
    • 共享展示位: 先清除主展示位。
    • 双展示位: 不要清除主展示位。
  4. 广告播放器已准备就绪。在广告播放器上设置展示位(共享展示位,或双展示位模式下的广告展示位)。播放会自动开始。
  5. 广告结束。清理广告展示位,清理广告播放器,然后恢复主要内容:
    • 共享展示位: 恢复之前再次在主播放器上设置主展示位。
    • 双展示位: 恢复主内容。无需再次设置主展示位。
特征:
  • 过渡期间可能会出现短暂的黑屏或暂停画面
  • 按需加载广告
  • 更简单的实现
  • autoPlay设置:true(自动播放)

广告时长强制实施

如果广告的定义时长小于实际媒体时长,您可以通过位置或时间更新侦听器,在正确的时间强制结束广告:
在无头方式中,使用在广告播放器会话上注册的位置侦听器,将当前播放位置与预期广告时长进行比对。

连播广告

当您的广告插播包含多个连续广告时,您可以根据设备功能采用三种方法:
  • 单一广告播放器(资源受限的设备): 一次只能创建一个广告播放器来播放单个广告。这可能无法提供无缝或无间隙的过渡,仅建议内存或解码器受限的设备使用。
  • 多个广告播放器(高性能设备): 使用两个广告播放器实例实现无缝的连播广告播放。提供连续广告之间的无缝过渡。需要足够的设备资源。
  • 主要内容播放器重建(替代方法): 存储主要内容的当前播放位置。在上次广告播放期间重建主播放器。这样可以在资源受限的设备上创建两个独立的广告播放器。

挑战

在实现客户端或服务器引导的广告插入时,请考虑以下挑战:
  • 缓冲和延迟: 当按需加载广告(即时广告)时,暂停内容以加载广告可能会导致缓冲或延迟。为了解决这个问题,预缓冲的广告在实际展示时间之前缓冲广告内容,只在足够的缓冲时间后才暂停主要内容。
  • 设备兼容性: 由于硬件功能(内存、解码器、处理能力)不同,不同设备的性能不一致。
  • 单展示位渲染: 在渲染完主内容的最后一帧之后,广告必须从第一帧开始播放。在展示位切换期间,不应出现丢帧或帧重叠的情况。双展示位模式通过使用独立的展示位来避免此问题。
  • 展示位清除时的黑屏闪烁问题: 在共享展示位模式下,调用clearSurfaceHandle (JS) 或clearVideoView(无头)会清空显示缓冲区,导致在主内容最后一帧与广告第一帧之间出现明显的黑帧。建议使用双展示位模式来规避。

选择您的实现方法

Vega为CSAI和SGAI提供了两种实现方法。两者都支持共享展示位模式和双展示位模式。选择与您的应用架构相匹配的方法。

JS方法

JS方法使用直接React Native组件集成。VideoPlayer实例在用户界面组件层中创建和管理。应用程序可以直接访问W3C媒体API,并通过直接方法调用来控制播放。
在共享展示位模式下,两个播放器轮流渲染到主展示位。在双展示位模式下,广告播放器渲染到主展示位上方的自有展示位。 在以下情况下使用此方法:
  • 您的应用使用单线程React Native架构
  • 您想直接访问W3C媒体API
  • 您更偏好更简单的组件级播放器管理
程序包:@amazon-devices/react-native-w3cmedia 要实现这种方法,请参阅使用JS方法实现客户端广告插入。

无头方法

无头方法使用客户端-服务器架构。用户界面层中的IPlayerClient实例通过KeplerPlayerClientTurboModule,使用JavaScript接口 (JSI) 与在独立服务层中管理的VideoPlayer实例进行通信,以实现高性能的进程间通信 (IPC)。
在共享展示位模式下,两个播放器会话轮流渲染到主展示位。在双展示位模式下,广告播放器会话渲染到主展示位上方的自有展示位。 在以下情况下使用此方法:
  • 您的应用使用具有独立用户界面和服务层的多线程架构
  • 您需要基于JSI的IPC的性能优势
  • 您想用PlayerSession进行基于会话的播放器管理
程序包: Vega播放器客户端和Vega播放器服务器 要实现这种方法,请参阅使用无头方法实现客户端广告插入。

相关内容


最后修改于 2026年10月5日