虚拟背景功能
功能介绍
SDK内置的虚拟背景功能,能够帮助用户在音视频通话或互动直播场景中,对视频中的背景进行替换处理。
使用需要集成plugins目录下的CRBeauty库
当前支持的类型和效果如下:
| 类型 | 枚举 | 效果 |
|---|---|---|
| 绿幕 | VBKT_COLORKEY | ![]() |
| Ai人像 | VBKT_HUMANONLY | ![]() |
1.开通虚拟背景功能授权
联系商务经理,为所用帐号开通虚拟背景功能授权。
2.集成美颜功能
美颜功能需要在工程中引用plugins/CRVBackground.aar
3.开启虚拟背景功能
调用startVirtualBackground,并传入虚拟背景参数,即可开启虚拟背景功能;
目前只支持对默认摄像头进行虚拟背景,可以调用setDefaultVideo来调整默认摄像头;
开启Ai人像虚拟背景成功后,将带来不少cpu开销,且视频分辨率越高开销将越大;
如开启Ai人像模式:
String vbkParams = "{"type":2, "bkImgFile":"/sdcard/imgs/1.jpg"}";
RTCMeeting.getInstance().startVirtualBackground(vbkParams);
相关API请参考:
4.更新虚拟背景参数
调用updateVirtualBackgroundParams,传入新的虚拟背景参数。
如更新背景图:
String vbkParams = "{"type":2, "bkImgFile":"/sdcard/imgs/1.jpg"}";
RTCMeeting.getInstance().updateVirtualBackgroundParams(vbkParams);
相关API请参考:
5.关闭虚拟背景功能
调用stopVirtualBackground,可以关闭虚拟背景功能;
stopVirtualBackground后,之前配置的虚拟背景参数将失效, 下次开启时需要重新按需设置;
相关API请参考:

