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预初始化广告播放器客户端,并注册侦听器以了解广告何时缓冲以及何时结束。
-
设置位置侦听器以检测即将到来的广告插播。
-
创建广告播放器客户端初始化函数。注册状态侦听器以检测READY和ENDED状态。在
IPlayerSessionState.READY不可用的平台上,该服务会发送playerReady消息作为回退。
等待广告缓冲,然后暂停主要内容
在广告播放器发出READY(已缓冲)信号,且侦听器检测到广告开始时间已到来后,暂停主要内容。切换展示位并播放广告
当主要内容状态更改为PAUSED时,为广告播放器会话提供一个展示位并播放广告。- 共享展示位: 清除主会话的展示位,然后在广告会话上设置同一展示位。
- 双展示位: 在广告会话上设置广告展示位。不要清除主会话的展示位。

