as

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

先决条件

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

设置播放器引用

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

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

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

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

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

切换展示位并播放广告

当主要内容暂停时,清理主播放器的展示位并将其分配给广告播放器。

返回至主要内容

广告结束后,清理广告展示位,清理广告播放器,然后恢复主要内容。

清理资源

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

相关内容


最后修改于 2026年10月26日