如果你在使用 RESTful API 进行旁路推流时选择垂直布局(layoutType
= 1
),请阅读以下说明。
垂直布局的画面类型分为大视窗和小视窗,无用户的空画面为空视窗,具体说明如下:
maxResolutionUid
参数指定一个 UID 作为大视窗画面。如果该用户停止发流或退出频道,画面先显示为该用户视频最后一帧,布局刷新(每三秒刷新一次)后显示为画布背景色。小视窗画面按照频道内其他用户加入频道的时间先后顺序显示。如果小视窗用户 1 退出频道,小视窗用户 2 会占据小视窗用户 1 的视窗,依次替补。
当布局位上的用户仅发送音频流,或停止发布视频流,或人数不足导致存在空视窗(无用户视频画面),该布局位画面显示如下:
defaultPlaceholderImageUrl
字段,则显示默认背景图。defaultPlaceholderImageUrl
字段,则先显示为该用户视频最后一帧,布局刷新后显示为画布背景色。不同人数范围的实际布局效果如下图所示:
人数(人) | 布局效果 | 说明 |
---|---|---|
1 | 若未设置 maxResolutionUid ,1 人的布局样式是铺满全屏。若设置了 maxResolutionUid ,但该用户还未加入频道,其他用户加入频道时按照 1-5 人的布局展示在右侧。 |
|
1-5 | 你可以指定用户作为大视窗 1,频道内其他用户按照加入频道的时间顺序显示为视窗 2-5。右侧小视窗宽度占总宽度的 1/5,高度占总高度的 1/4。 | |
6-7 | 你可以指定用户作为大视窗 1,频道内其他用户按照加入频道的时间顺序显示为视窗 2-7。右侧小视窗宽度占总宽度的 1/7,高度占总高度的 1/6。 | |
8-9 | 你可以指定用户作为大视窗 1,频道内其他用户按照加入频道的时间顺序显示为视窗 2-9。右侧小视窗宽度占总宽度的 1/9,高度占总高度的 1/8。 | |
10-17 | 你可以指定用户作为大视窗 1,频道内其他用户按照加入频道的时间顺序显示为视窗 2-17。右侧小视窗宽度占总宽度的 1/10,高度占总高度的 1/8。 | |
18-33 | 你可以指定用户作为大视窗 1,频道内其他用户按照加入频道的时间顺序显示为视窗 2-33。右侧小视窗宽度占总宽度的 1/10,高度占总高度的 1/8。 | |
34-49 | 你可以指定用户作为大视窗 1,频道内其他用户按照加入频道的时间顺序显示为视窗 2-49。右侧小视窗宽度占总宽度的 1/14,高度占总高度的 1/12。 |