as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
在本教程中,您将使用无头方法在Vega应用中实现客户端广告插入 (CSAI)。这种方法使用客户端-服务器架构,其中用户界面层中的IPlayerClient实例通过基于JavaScript接口 (JSI)的进程间通信 (IPC) 与独立服务层中的VideoPlayer实例进行通信。您将设置双播放器架构,其中主播放器客户端用于播放内容,广告播放器客户端用于在广告时段播放广告,广告播放器可以在与主播放器共享的视频展示位播放,也可以在其专属的独立展示位播放。 本教程中的示例演示了用于实现无缝广告过渡的预缓冲广告。有关CSAI概念、技巧和同步策略的背景信息,请参阅Vega中的客户端广告插入。 在本教程中,您将学习如何:
  • 设置播放器客户端引用和导入
  • 将视频展示位设置为共享或双展示位模式
  • 检测广告标记并预初始化广告播放器客户端
  • 等待广告缓冲,然后暂停主要内容
  • 切换视频展示位并播放广告
  • 广告结束后返回至主要内容

先决条件

  • Vega开发环境已设置
  • Vega SDK v0.22或更高版本
  • @amazon-devices/kepler-player-client和@amazon-devices/kepler-player-server程序包已安装
  • 主要内容播放器客户端已初始化并已连接到服务
  • React Native和TypeScript的基础知识

设置播放器客户端引用

导入所需的程序包并为主播放器客户端、广告播放器客户端、会话ID和展示位句柄创建引用。

设置视频展示位

选择展示位模式。有关模式之间的差异,请参阅展示位模式。
  • 共享展示位: 渲染一个KeplerVideoSurfaceView并将它的句柄存储到surfaceHandleRef中。两个播放器会话轮流使用该展示位。
  • 双展示位: 在主展示位上方为广告播放器会话渲染第二个KeplerVideoSurfaceView,并将其句柄存储到adSurfaceHandleRef中。
如果您的广告与主内容的宽高比不同,请参阅处理不同宽高比的广告。

检测广告标记并预初始化广告播放器客户端

当位置侦听器检测到即将到来的广告插播时,使用autoPlay=false预初始化广告播放器客户端,并注册侦听器以了解广告何时缓冲以及何时结束。
  1. 设置位置侦听器以检测即将到来的广告插播。
  2. 创建广告播放器客户端初始化函数。注册状态侦听器以检测READY和ENDED状态。在IPlayerSessionState.READY不可用的平台上,该服务会发送playerReady消息作为回退。

等待广告缓冲,然后暂停主要内容

在广告播放器发出READY(已缓冲)信号,且侦听器检测到广告开始时间已到来后,暂停主要内容。

切换展示位并播放广告

当主要内容状态更改为PAUSED时,为广告播放器会话提供一个展示位并播放广告。
  • 共享展示位: 清除主会话的展示位,然后在广告会话上设置同一展示位。
  • 双展示位: 在广告会话上设置广告展示位。不要清除主会话的展示位。

返回至主要内容

广告结束后,清理广告展示位,清理广告播放器客户端,然后恢复主要内容。在共享展示位模式下,恢复之前请再次在主会话上设置展示位。在双展示位模式下,主会话仍保留其展示位。

清理资源

当您的组件卸载或播放器会话结束时,卸载广告播放器客户端并释放资源。

相关内容


最后修改于 2026年10月5日