VideoPlayer实例在用户界面组件层中创建和管理。您将设置双播放器架构,其中主播放器用于播放内容,广告播放器用于在广告时段播放广告,广告播放器可以在与主播放器共享的视频展示位播放,也可以在其专属的独立展示位播放。
本教程中的示例演示了用于实现无缝广告过渡的预缓冲广告。有关CSAI概念、技巧和同步策略的背景信息,请参阅Vega中的客户端广告插入。
在本教程中,您将学习如何:
- 设置播放器引用和导入
- 将视频展示位设置为共享或双展示位模式
- 检测广告标记并预初始化广告播放器
- 等待广告缓冲,然后暂停主要内容
- 切换视频展示位并播放广告
- 广告结束后返回至主要内容
先决条件
- Vega开发环境已设置
- Vega SDK v0.22或更高版本
@amazon-devices/react-native-w3cmedia程序包已安装- 主内容播放器已经初始化并正在播放
- React Native和TypeScript的基础知识
设置播放器引用
导入所需的组件,为主播放器、广告播放器和展示位句柄创建引用。设置视频展示位
选择展示位模式。有关模式之间的差异,请参阅展示位模式。- 共享展示位: 渲染一个
KeplerVideoSurfaceView并将它的句柄缓存到cachedSurface中。两个播放器轮流使用该展示位。 - 双展示位: 在主展示位上方为广告播放器渲染第二个
KeplerVideoSurfaceView,并将其句柄缓存到adCachedSurface中。
检测广告标记并预初始化广告播放器
当应用检测到即将到来的广告插播时(例如,广告开始前5秒),预先初始化广告播放器,并使用autoPlay=false开始缓冲广告内容。
-
在主播放器上注册
timeupdate侦听器,以检测即将到来的广告插播。 -
创建广告播放器初始化函数。将
autoPlay设置为false,这样您就可以控制何时开始播放。
等待广告缓冲,然后暂停主要内容
在广告播放器发出已完成缓冲信号 (canplay) 且达到广告开始时间后,暂停主要内容。
切换展示位并播放广告
当主内容暂停时,为广告播放器提供一个展示位并播放广告。- 共享展示位: 清除主播放器的展示位,然后将同一展示位分配给广告播放器。
- 双展示位: 将广告展示位分配给广告播放器。不要清除主播放器的展示位。

