- CSAI — 带外: 应用使用外部时间表(而非清单标记)来确定何时插入广告。应用会获取VAST/VMAP并播放广告素材。
- CSAI — 带内边界标记: 清单会指示广告时段应出现的位置,但不会指示要播放的内容。客户端检测到标记并获取VAST以解析广告。
- SGAI — 服务器引导: 清单中包含可播放的广告URL。服务器已决定要播放的内容;播放器会直接获取并播放。
广告插入技术
CSAI — 带外(标准)
在标准CSAI中,客户端应用依靠外部信息,而不是清单标签来确定何时插入广告。播放器接收未经修改的内容清单并单独处理广告逻辑。 广告时机来自清单之外。来源包括:- VMAP: 播放器获取一个外部XML文件,该文件在特定时间戳(例如,在0秒、300秒)安排广告时段。
- 硬编码逻辑: 应用程序根据播放器当前的时间位置以固定的间隔触发广告请求(例如,每20秒一次)。
- 边车文件: 该应用从内容管理系统 (CMS) 下载单独的配置文件 (JSON/XML),该文件列出了特定内容的广告中断时间。
- 广告SDK: SDK(如Google Interactive Media Ads)通过广告规则在内部管理时间,从而无需开发者管理特定的时间戳或清单标签。
CSAI — 带内边界标记(高级)
在高级CSAI中,清单包含标记,指示“此处为广告时段”— 但不包含广告URL。客户端必须决定播放什么。 常见的边界标记包括:
当播放器遇到边界标记(例如
#EXT-X-CUE-OUT)时,它会将其解释为广告利用机会,并在指定的持续时间内向广告服务器发起VAST或VMAP请求。在主要内容继续播放的同时,会同时提取和缓冲广告内容。仅当达到广告展示时间时,主要内容才会暂停。届时,预计该广告可以开始播放,以提供无缝体验。
流: 解析清单 → 检测边界 → 客户端获取VAST → 解析 → 播放广告素材。
在使用无头方法的带内实现中,用户界面可以通过sendMessage({type: 'adList', ads})将广告列表发送到服务层,以提供与清单解析所生成数据相同的数据。该服务将广告列表存储在PlayerSession上,并在getCurrentPlaybackPosition()过程中处理广告标记。当达到广告的预缓冲窗口时(startTime前5秒),该服务会向用户界面发送{type: 'adMarkers', ad}消息,然后触发广告插入。
SGAI — 服务器引导的广告插入
在服务器引导的广告插入 (SGAI) 中,清单包含标记,指示“播放此URL”— 广告URL已存在。服务器已决定要播放的内容;播放器在解析清单时发现广告,从嵌入的URL获取广告素材并播放。 SGAI标记包括:
与CSAI不同,无需进行VAST解析或使用广告SDK。播放器解析清单以发现广告URL,获取广告媒体,暂停内容,播放广告流,然后恢复内容。播放器还会在存在
X-RESTRICT(跳过/跳转限制)和CUE(前贴片/后贴片行为)属性时强制执行这些属性。
流: 解析清单 → 提取广告URL → 获取并播放(无VAST,无广告SDK)。
与CSAI的主要区别:
- 应用不提供广告标签URL — 清单本身就是广告时间表。
- 无需解析VAST/VMAP — URL直接指向可播放的
.m3u8或.mpd媒体。 - 服务器预先决定要投放哪个广告。无法进行实时客户端个性化。
- 清单可在CDN处缓存(不像SSAI那样按观看者进行个性化)。
展示位模式
所有三种广告插入技术都采用双播放器架构: 主播放器用于内容,广告播放器用于广告。两个播放器可以共享一个视频展示位,也可以各自拥有独立的展示位。单展示位(共享)
主播放器和广告播放器共用同一个KeplerVideoSurfaceView。主播放器必须在广告播放器渲染展示位前将其释放:
- JS方法: 在主播放器上调用
clearSurfaceHandle(surfaceHandle),然后在广告播放器上调用setSurfaceHandle(surfaceHandle)。 - 无头方法: 在主播放器会话上调用
clearVideoView(sessionId),然后在广告播放器会话上调用setVideoView(surfaceHandle, sessionId)。
双展示位
每个播放器都有自己专属的KeplerVideoSurfaceView。广告位通过zIndex定位,叠加在主内容区域之上。广告播放时,主播放器无需释放其展示位,广告结束时也无需再次设置。
展示位视图布局 (JSX)
主内容展示位使用zIndex: 1,广告展示位使用zIndex: 2,因此广告会在顶层渲染:
处理不同宽高比的广告(双展示位)
当广告和主内容的宽高比相同(例如均为16:9)时,广告位会直接叠加主内容。无需额外处理。 当两者的宽高比不同时,由于尺寸不匹配,非活动表面会在活动表面后方透出来。为避免此问题,可使用屏幕外渲染,将非活动展示位移到屏幕外:const [adSurfaceVisible, setAdSurfaceVisible] = useState(false),并在广告开始时将其切换为true,在广告结束时切换为false。
播放同步策略
所有三种广告插入技术都支持两种策略,用于在过渡期间协调主播放器和广告播放器。展示位步骤因您使用共享展示位还是双展示位而有所不同。预缓冲广告(无缝)
广告播放器在过渡之前会预先初始化并缓冲。这提供了没有视觉干扰的无缝用户体验。- 主要内容播放。
- 检测到广告标记。使用
autoPlay=false预初始化广告播放器。 - 广告播放器缓冲区。
canplay事件触发 (JS) 或服务发送READY状态(无头)。 - 用户界面收到就绪信号。广告已准备好播放,等待预定的播放时间。
- 位置侦听器会检测到已达到广告开始时间。暂停主要内容。
- 主要内容已暂停。切换到广告并开始播放:
- 共享展示位: 清除主展示位,在广告播放器上设置同一展示位,然后播放广告。
- 双展示位: 在广告播放器上设置广告展示位并播放广告。不要清除主展示位。
- 广告结束。清理广告展示位,清理广告播放器,然后恢复主要内容:
- 共享展示位: 恢复之前再次在主播放器上设置主展示位。
- 双展示位: 恢复主内容。主展示位从未被清除,因此无需再次设置。
- 没有视觉干扰
- 播放前对广告内容进行预缓冲
- 最适合优质观看体验
autoPlay设置:false(手动控制)
即时自动播放广告(有间隔)
广告中断发生时,将按需初始化广告播放器。由于广告在播放时使用autoPlay=true加载,因此在广告播放器初始化期间可能会有短暂的过渡间隔。
- 主要内容播放。
- 检测到广告标记。暂停主要内容。
- 主要内容已暂停。使用
autoPlay=true初始化广告播放器:- 共享展示位: 先清除主展示位。
- 双展示位: 不要清除主展示位。
- 广告播放器已准备就绪。在广告播放器上设置展示位(共享展示位,或双展示位模式下的广告展示位)。播放会自动开始。
- 广告结束。清理广告展示位,清理广告播放器,然后恢复主要内容:
- 共享展示位: 恢复之前再次在主播放器上设置主展示位。
- 双展示位: 恢复主内容。无需再次设置主展示位。
- 过渡期间可能会出现短暂的黑屏或暂停画面
- 按需加载广告
- 更简单的实现
autoPlay设置:true(自动播放)
广告时长强制实施
如果广告的定义时长小于实际媒体时长,您可以通过位置或时间更新侦听器,在正确的时间强制结束广告:连播广告
当您的广告插播包含多个连续广告时,您可以根据设备功能采用三种方法:- 单一广告播放器(资源受限的设备): 一次只能创建一个广告播放器来播放单个广告。这可能无法提供无缝或无间隙的过渡,仅建议内存或解码器受限的设备使用。
- 多个广告播放器(高性能设备): 使用两个广告播放器实例实现无缝的连播广告播放。提供连续广告之间的无缝过渡。需要足够的设备资源。
- 主要内容播放器重建(替代方法): 存储主要内容的当前播放位置。在上次广告播放期间重建主播放器。这样可以在资源受限的设备上创建两个独立的广告播放器。
挑战
在实现客户端或服务器引导的广告插入时,请考虑以下挑战:- 缓冲和延迟: 当按需加载广告(即时广告)时,暂停内容以加载广告可能会导致缓冲或延迟。为了解决这个问题,预缓冲的广告在实际展示时间之前缓冲广告内容,只在足够的缓冲时间后才暂停主要内容。
- 设备兼容性: 由于硬件功能(内存、解码器、处理能力)不同,不同设备的性能不一致。
- 单展示位渲染: 在渲染完主内容的最后一帧之后,广告必须从第一帧开始播放。在展示位切换期间,不应出现丢帧或帧重叠的情况。双展示位模式通过使用独立的展示位来避免此问题。
- 展示位清除时的黑屏闪烁问题: 在共享展示位模式下,调用
clearSurfaceHandle(JS) 或clearVideoView(无头)会清空显示缓冲区,导致在主内容最后一帧与广告第一帧之间出现明显的黑帧。建议使用双展示位模式来规避。
选择您的实现方法
Vega为CSAI和SGAI提供了两种实现方法。两者都支持共享展示位模式和双展示位模式。选择与您的应用架构相匹配的方法。JS方法
JS方法使用直接React Native组件集成。VideoPlayer实例在用户界面组件层中创建和管理。应用程序可以直接访问W3C媒体API,并通过直接方法调用来控制播放。
- 您的应用使用单线程React Native架构
- 您想直接访问W3C媒体API
- 您更偏好更简单的组件级播放器管理
@amazon-devices/react-native-w3cmedia
要实现这种方法,请参阅使用JS方法实现客户端广告插入。
无头方法
无头方法使用客户端-服务器架构。用户界面层中的IPlayerClient实例通过KeplerPlayerClientTurboModule,使用JavaScript接口 (JSI) 与在独立服务层中管理的VideoPlayer实例进行通信,以实现高性能的进程间通信 (IPC)。
- 您的应用使用具有独立用户界面和服务层的多线程架构
- 您需要基于JSI的IPC的性能优势
- 您想用
PlayerSession进行基于会话的播放器管理
相关内容
- 使用JS方法实现客户端广告插入
- 使用无头方法实现客户端广告插入
- 共享展示位和双展示位实现:

