TUICallKit 推出了虚拟背景新特性,让用户在视频通话时,可设置模糊背景或图片背景,隐藏真实通话环境,保护隐私,让通话更有趣。 接下来,本文将详细介绍在 TUICallKit 组件中如何使用这一特性。
集成效果
TUICallKit 组件接入虚拟背景功能后的显示效果如下:
原始摄像头 | 模糊背景效果 | 图片背景效果 |
| | |
准备条件
1. 在使用腾讯云提供的虚拟背景功能前,您需要前往控制台,为应用开通音视频服务,购买
群组通话版(140万分钟)
套餐。具体步骤请参见 开通服务。2. 下载 虚拟背景模型 文件,解压后,拷贝
LiteavSegmentModel.zip
文件到项目的 assets
目录下。
3. 在工程的
tuicallkit-kt
目录下,找到build.gradle
文件,替换文件中的TRTC SDK
版本为 Professional 版本。api "com.tencent.liteav:LiteAVSDK_Professional:11.8.0.14176"
注意:
开启模糊背景
TUICallKit 的 UI 方案支持设置模糊背景。通过调用以下接口,您可以在 UI 上显示模糊背景的功能按钮,点击按钮可直接启用模糊背景功能。
TUICallKit.createInstance(getApplicationContext()).enableVirtualBackground(true);
设置图片背景(可选)
图片背景需要用户自行实现,将图片保存在本地后,调用以下接口进行设置(目前只支持本地路径的图片,网络图片暂时不支持)。
TUICallEngine.createInstance(context).setVirtualBackground("imagePath", null)
常见问题
1. 开启模糊背景无反应或有延迟
确保已购买音视频通话
群组通话版(140万分钟)
套餐,详见 开通服务。确保已下载模型文件至本地。
如果没有添加模型文件到本地路径中,在开启模糊背景功能的时候,SDK 内部才会去下载模型文件,正常网络情况下,下载耗时1~3s,网络越差耗时越久。
检查模型文件与 SDK 是否匹配。
2. 模型文件与SDK的匹配
TUICallKit 是基于 IM SDK 和 TRTC SDK 实现的音视频通话场景,虚拟背景是 TRTC SDK 提供的特色功能。虚拟背景模型文件与 TRTC SDK 的版本有匹配关系。若不匹配,可能导致开启模糊背景无效果。请查看下表了解模型文件与 TRTC SDK 的对应关系:
SDK 版本 | 虚拟背景模型文件下载地址· |
com.tencent.liteav:LiteAVSDK_Professional:11.7.0.12001 | |
com.tencent.liteav:LiteAVSDK_Professional:11.8.0.14176 |