虚拟背景
功能介绍
SDK内置的虚拟背景功能,能够帮助用户在音视频通话或互动直播场景中,对视频中的背景进行替换处理。
当前支持的类型和效果如下:
| 类型 | 枚举 | 效果 |
|---|---|---|
| 绿幕 | CRVSDK_VBKTP_COLOR | ![]() |
| Ai人像 | CRVSDK_VBKTP_HUMAN | ![]() |
1.开通虚拟背景功能授权
联系商务经理,为所用账号开通虚拟背景功能授权。
2.开启虚拟背景
调用startVirtualBackground,并传入虚拟背景参数,即可开启虚拟背景;
目前只支持对默认视频设备进行虚拟背景,可以调用setDefaultVideo来调整默认视频设备;
开启Ai人像虚拟背景成功后,将带来不少cpu开销,且视频分辨率越高开销将越大;
Ai人像虚拟背景当前仅windows 8+、macOS支持开启虚拟背景;
如开启Ai人像模式:
const char* vbkParams = R"({"type":2, "bkImgFile":"d:\imgs\1.jpg"})";
g_sdkMain->getSDKMeeting().startVirtualBackground(vbkParams);
相关API请参考:
3.更新虚拟背景参数
调用updateVirtualBackgroundParams,传入新的虚拟背景参数。
如更新背景图:
const char* vbkParams = R"({"type":2, "bkImgFile":"d:\imgs\2.jpg"})";
g_sdkMain->getSDKMeeting().updateVirtualBackgroundParams(beautyParams);
相关API请参考:
4.关闭虚拟背景
调用stopVirtualBackground,可以关闭虚拟背景;
stopVirtualBackground后,之前配置的虚拟背景参数将失效, 下次开启时需要重新按需设置;
相关API请参考:

