音视频通话

虚拟背景功能

功能介绍

SDK内置的虚拟背景功能,能够帮助用户在音视频通话或互动直播场景中,对视频中的背景进行替换处理。
当前支持的类型和效果如下:

类型 效果
绿幕
Ai人像

集成说明

注意:

如需开启虚拟背景功能,务必在SDK安装前,添加配置项,否则无法使用虚拟背景功能。参见集成SDK

1.开通虚拟背景功能授权

联系商务经理,为所用帐号开通虚拟背景功能授权。

2.开启虚拟背景功能

调用startVirtualBackground,并传入虚拟背景参数,即可开启虚拟背景功能;
目前只支持对默认摄像头进行虚拟背景,可以调用setDefaultVideo来调整默认摄像头;
开启Ai人像虚拟背景成功后,将带来不少cpu开销,且视频分辨率越高开销将越大;
当前仅windows 8+支持开启虚拟背景功能;

如开启Ai人像模式:

const sdkErr = rtcsdk.startVirtualBackground({
    type: 2,
    bkImgFile: "C:\Users\xxx\Desktop\test.jpg",
});
if (sdkErr !== 0) {
    console.error('开启失败,错误码: ' + sdkErr);
}

相关API请参考:

3.更新虚拟背景参数

调用updateVirtualBackgroundParams,传入新的虚拟背景参数。

如更新背景图:

const sdkErr = rtcsdk.updateVirtualBackgroundParams({
    type: 2,
    bkImgFile: "d:\imgs\2.jpg",
});

相关API请参考:

4.关闭虚拟背景功能

调用stopVirtualBackground,可以关闭虚拟背景功能;
stopVirtualBackground后,之前配置的虚拟背景参数将失效, 下次开启时需要重新按需设置;

相关API请参考: