实时音视频
实时音视频
文档指南
请输入
- 文档首页
实时音视频实时音视频开发指南视频管理虚拟背景Native 端虚拟背景
复制全文
下载 pdfNative 端虚拟背景
文档反馈
问问助手在互动直播、视频会议、在线授课等场景下，可将用户人像和背景分离，采用自定义图片或纯色作为虚拟背景，从而避免杂乱背景对观众的影响，保护用户隐私，呈现较高的视频效果。你可以参考本文，实现这一功能。
前提条件
你已经集成了 3.50 及以上版本的 RTC SDK，并实现音视频通话功能。
对于移动端，需要确保 CV 许可证和 CV 资源被拷贝至 App 内，安卓端需要将 CV 资源拷贝至外部存储后方可使用。
操作步骤
以 Android 平台为例：
- 检查 CV 许可证，并设置算法模型。证书路径为 *.licbag 文件的绝对路径，算法模型路径为 ModelResource.bundle 的绝对路径。
- IVideoEffect mVideoEffect = mRTCVideo.getVideoEffectInterface();mVideoEffect.initCVResource("## 授权证书绝对路径 ##", "## 算法模型文件夹路径 ##")
- 此步骤可能返回的错误码及应对方式如下：
- initCVResource 返回的错误码错误码含义排查措施0集成特效 SDK 成功，可进行下一步操作无–1000特效 SDK 集成失败–121授权证书路径不存在检查授权证书是否拷贝到该参数指定的路径–119授权证书和包名不匹配检查授权证书绑定的包名是否和当前 app 包名一致–117授权证书已过期更新授权证书其他错误码
- initCVResource 调用成功后，你可以开启虚拟背景，虚拟背景支持纯色背景和图片背景。
- a. 开启纯色背景
- VirtualBackgroundSource source = new VirtualBackgroundSource();// 选择纯色背景source.sourceType = VirtualBackgroundSourceType.COLOR;// 设置背景颜色，背景颜色格式为 0xAARRGGBB，例如绿色source.sourceColor = 0XFF00FF00;// 开启纯色背景IVideoEffect mVideoEffect = mRTCVideo.getVideoEffectInterface();mVideoEffect.enableVirtualBackground("## 背景贴纸素材绝对路径 ##", source);
- b. 开启图片背景
- VirtualBackgroundSource source = new VirtualBackgroundSource();// 选择图片背景source.sourceType = VirtualBackgroundSourceType.IMAGE;// 设置背景图片绝对路径source.sourcePath = "/storage/emulated/0/Download/test.png";// 开启图片背景IVideoEffect mVideoEffect = mRTCVideo.getVideoEffectInterface();mVideoEffect.enableVirtualBackground("## 背景贴纸素材绝对路径 ##", source);
- c. 关闭虚拟背景
- // 关闭虚拟背景IVideoEffect mVideoEffect = mRTCVideo.getVideoEffectInterface();mVideoEffect.disableVirtualBackground();
- d. 切换虚拟背景
- VirtualBackgroundSource source = new VirtualBackgroundSource();// 选择图片背景source.sourceType = VirtualBackgroundSourceType.IMAGE;// 设置背景图片绝对路径source.sourcePath = "/storage/emulated/0/Download/test.png";// 设置背景颜色，例如绿色source.sourceColor = 0XFF00FF00;// 开启图片背景IVideoEffect mVideoEffect = mRTCVideo.getVideoEffectInterface();mVideoEffect.enableVirtualBackground("## 背景贴纸素材绝对路径 ##", source);// 切换到绿色背景source.sourceType = VirtualBackgroundSourceType.COLOR;mVideoEffect.enableVirtualBackground("## 背景贴纸素材绝对路径 ##", source);
- 此步骤可能返回的错误码及应对方式如下：
- enableVirtualBackground 返回的错误码错误码含义排查措施0虚拟背景成功开启无–2背景素材路径不存在检查虚拟背景素材路径是否正确–4背景图片打开失败检查背景图片路径是否有效–38背景图片格式不支持检查背景图片后缀是否为 jpg、png–37背景图片数据损坏检查背景图片的内容其他错误码
API 参考
- Android
- iOS
- Windows
最近更新时间：2026.08.04 14:36:36
这个页面对您有帮助吗？
有用
有用
无用
无用