华为云首页用户手册

实时音视频 SPARKRTC-合流录制:合流布局

时间：2024-04-21 20:54:17

实时音视频 SPARKRTC

合流布局

在合流录制模式下，支持分屏九宫格模板和共享屏幕模板（主视窗居左/主视窗居右）两种预设合流布局。同时，也支持用户自定义合流布局样式（自定义视频窗格位置）。

九宫格模板
每个用户画面平铺在画布上，大小一致。根据用户数量，动态调整每个画面的大小和位置。最多支持25个画面。不同人数的实际布局效果如下图所示。
- 如果实际视频流的宽高比与视窗的宽高比不一致，视频画面会裁剪以适配视窗的大小。
- 中途有流退出房间，则该条流的画面会被后进入房间的流顶替。
- 如果房间内的人数不足，则剩余位置显示背景色。
- 如果用户只发送音频，仍然会占用画面位置。
- 支持背景图，如果房间内人数不足，显示背景图。

屏幕共享模板
屏幕分享（或者主讲人摄像头画面）始终占据屏幕左侧或者右侧大画面位置，其他用户依次垂直排列于旁边。最多支持17个画面。不同人数的实际布局效果如下图所示。
- 大视窗画面，可选择主讲摄像头流或共享屏幕流。
- 大视窗画面，显示指定的UID用户的视频，如果未指定或者指定用户未进入频道，大视窗区域显示背景色。
- 左侧大视窗为了保持内容的完整性采用缩放方式处理，右侧小视窗采用裁剪方式适配视窗的大小。
- 右侧小视窗画面按照加入房间的时间先后顺序排列。
- 右侧小视窗有流退出房间，则该条流的画面会被后进入房间的流顶替。
- 如果房间内的人数不足，则剩余位置显示背景色。
- 如果用户只发送音频，仍然会占用画面位置。
- 支持背景图，如果房间内人数不足，显示背景图。
自定义布局模板
支持用户自定义合流布局样式，可灵活设置用户画面的大小，指定用户画面在视频画布上的相对位置。
- 可自定义各个视频窗格在画布上的位置。
- 可自定义各个视频窗格的宽和高。
- 针对每一个窗格，可通过user_id指定显示房间内某一用户。
- 针对窗格，可自定义选择呈现摄像头流或者屏幕分享流。
- 如果实际视频流的宽高比与视窗的宽高比不一致，自定义布局场景下支持选择裁剪和缩放两种模式。
- 如果房间内的人数不足，则剩余位置显示背景色。
- 如果用户只发送音频，仍然会占用画面位置。
- 支持背景图，如果房间内人数不足，则显示背景图。