音视频通话

视频大小流支持

功能介绍

在某些业务场景下,同一房间内的用户视图不一致,导致同一个视频在不同用户那里呈现的画面尺寸不一样。例如 9 方通话中,某用户全屏观看 A 的视频时,A 需要编码高分辨率视频,但其他用户只看 A 的小窗口,收到高分辨率流会浪费带宽和解码性能。

对此可启用视频大小流机制:看小画面的用户订阅小流,看大画面的用户订阅大流。

注意:

成功进入房间后,才可以配置大小流。

1. 发送端配置大小流

设置默认视频为大流,第二档为小流:

// 配置默认大流使用 720p
VideoCfg cfg = RTCMeeting.getInstance().getVideoCfg();
cfg.size = new Size(1280, 720);
RTCMeeting.getInstance().setVideoCfg(cfg);

// 配置第二档小流使用 360p
short videoID = RTCMeeting.getInstance().getDefaultVideo(myUserID);
VideoAttributes specialVideoAttr = RTCMeeting.getInstance().getLocVideoAttributes(videoID);
VideoCfg smallCfg = new VideoCfg();
smallCfg.size = new Size(640, 360);
specialVideoAttr.quality2Cfg = smallCfg;
RTCMeeting.getInstance().setLocVideoAttributes(videoID, specialVideoAttr);

相关 API 请参考:

2. 接收端选择大小流

VideoUIView videoView = findViewById(R.id.video_view);
UsrVideoId videoId = new UsrVideoId(userID, (short) -1);

// 用小流查看
videoView.setUsrVideoId(videoId, 2);

// 切换为大流查看
videoView.setUsrVideoId(videoId, 1);

qualityLv 说明:1=默认档位,2=第二档,3=第三档;若对应档位未开启则显示 1 档视频流。

相关 API 请参考:

3. 最佳实践

更多多方视频布局与编码参数建议参见 多方视频通话。