as

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

先决条件

  • Vega开发环境已设置
  • Vega SDK v0.22或更高版本
  • @amazon-devices/react-native-w3cmedia程序包已安装
  • 主内容播放器已经初始化并正在播放
  • React Native和TypeScript的基础知识

设置播放器引用

导入所需的组件,为主播放器、广告播放器和展示位句柄创建引用。

设置视频展示位

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

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

当应用检测到即将到来的广告插播时(例如,广告开始前5秒),预先初始化广告播放器,并使用autoPlay=false开始缓冲广告内容。
  1. 在主播放器上注册timeupdate侦听器,以检测即将到来的广告插播。
  2. 创建广告播放器初始化函数。将autoPlay设置为false,这样您就可以控制何时开始播放。

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

在广告播放器发出已完成缓冲信号 (canplay) 且达到广告开始时间后,暂停主要内容。

切换展示位并播放广告

当主内容暂停时,为广告播放器提供一个展示位并播放广告。
  • 共享展示位: 清除主播放器的展示位,然后将同一展示位分配给广告播放器。
  • 双展示位: 将广告展示位分配给广告播放器。不要清除主播放器的展示位。

返回至主要内容

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

清理资源

当您的组件卸载或播放器会话结束时,取消两个播放器的初始化并释放展示位句柄。

相关内容


最后修改于 2026年10月5日