多方视频通话
功能介绍
在多方视频通话中,按业务场景合理配置视频编码参数,可在控制带宽占用的同时,保证画面流畅、观感清晰。下文分几种常见场景说明。
1. 一对一
- 画中画布局示例:

适用于双人视频聊天等场景:双方通常都希望看清对方画面,可采用较高编码分辨率,例如 720P 或 480P。
- 示例代码:
// 将本地视频编码为 720P,帧率 15(对方也应同等配置)
const char* vCfg = R"({ "size":"1280*720", "fps":15 })";
g_pCRVideoSDKMain->getSDKMeeting().setVideoCfg(vCfg);
// 对方画面为大图
KVideoUI *pBig = new KVideoUI(pDlg);
pBig->move(0,0);
pBig->resize(pDlg->size());
pBig->setVideoID(CRUserVideoID(peerUserID));
// 本地画面为小图
KVideoUI *pSmall = new KVideoUI(pDlg);
pSmall->raise();
pSmall->move(pDlg->width()*2/3, pDlg->height()*2/3);
pSmall->resize(pDlg->width()/3, pDlg->height()/3);
pSmall->setVideoID(CRUserVideoID(myUserID));
相关 API:
2. 多方视频
- 多方视频布局示例:

常见于在线教育等场景:主讲(教师)画面较大,可采用较高分辨率(如 720P);下方学员画面较小,宜采用较低编码分辨率(如 360P 或 256P),以节省总体带宽。
- 示例代码:
// 创建 5 个视频 UI 并绑定画面
KVideoUI *vuis[5];
for(int i=0; i<5; i++)
{
vuis[i] = new KVideoUI(pDlg);
}
vuis[0]->setVideoID(CRUserVideoID(UserID_teacher));
vuis[1]->setVideoID(CRUserVideoID(UserID_stu1));
vuis[2]->setVideoID(CRUserVideoID(UserID_stu2));
vuis[3]->setVideoID(CRUserVideoID(UserID_stu3));
vuis[4]->setVideoID(CRUserVideoID(UserID_stu4));
// 对话框整体布局
QVBoxLayout* bkLay = new QVBoxLayout(pDlg);
// 顶部:大窗口(教师)
QHBoxLayout* topLayout = new QHBoxLayout;
topLayout->addWidget(vuis[0]);
bkLay->addLayout(topLayout);
// 大画面高度约为窗口的 1/4,宽度按约 16:9 推算
int mainVideoH = pDlg->height()/4;
int mainVideoW = mainVideoH*19/9;
vuis[0]->resize(mainVideoW, mainVideoH);
// 底部:横向排列 4 个小窗口(学员)
QHBoxLayout* botLayout = new QHBoxLayout;
for(int i=1; i<5; i++)
{
botLayout->addWidget(vuis[i]);
}
bkLay->addLayout(botLayout);
// 本地编码:大画面角色用高分辨率,其余用低分辨率
CRVideoCfg vCfg;
if ( myUserID==UserID_teacher )
{
vCfg._size = CRSize(1280, 720);
}
else
{
vCfg._size = CRSize(456, 256);
}
vCfg._fps = 15;
g_pCRVideoSDKMain->getSDKMeeting().setVideoCfg(vCfg);
相关 API:
3. 个性化视图
- 图一:

- 图二:

说明: 部分业务中,同一房间内不同用户看到的布局不一致,同一路视频在不同终端上的显示尺寸也不同。例如九方通话时,九个画面平铺(图一),每人只需编码约 256P 即可。若某时刻用户 B 全屏观看用户 A(图二),则 A 需提高编码分辨率(如 720P),B 才能看清细节。此时房间内其他人仍以小块画面观看 A,却同样收到 720P 码流,会浪费带宽与解码算力;若多人同时放大观看不同成员,整体通话质量可能明显恶化。
对此可启用视频大小流支持:只看 A 小画面的终端订阅 A 的小流,全屏或大屏观看的终端订阅 A 的大流,在满足不同清晰度需求的同时,避免无谓的带宽与 CPU 消耗。
- 示例代码:
// 开启大小流:大流 720P,小流 256P
string videoAttributesObj = "[{\"size\":\"1280*720\", \"fps\":12, \"quality2\":{\"size\":\"456*256\"}}]";
int videoID = axVideoSDK.getDefaultVideo(UserID);
g_pCRVideoSDKMain->getSDKMeeting().setLocVideoAttributes(videoID, videoAttributesObj);
// 订阅该用户的大流
pVideoUI->setVideoID(CRUserVideoID(userID));
// 订阅该用户的小流(需已通过 setLocVideoAttributes 配置 quality2)
pVideoUI->setVideoID(CRUserVideoID(userID), CRVSDK_VSTP_LV1);
相关 API: