有奖捉虫:行业应用 & 管理与支持文档专题 HOT
TUICallKit 推出了虚拟背景新特性,让用户在视频通话时,可设置模糊背景或图片背景,隐藏真实通话环境,保护隐私,让通话更有趣。 接下来,本文将详细介绍在 TUICallKit 组件中如何使用这一特性。

集成效果

TUICallKit 组件接入虚拟背景功能后的显示效果如下:
原始摄像头
模糊背景效果
图片背景效果










准备条件

1. 在使用腾讯云提供的虚拟背景功能前,您需要前往控制台,为应用开通音视频服务,购买群组通话版(140万分钟)套餐。具体步骤请参见 开通服务。
2. 指定 LiteAVSDK_Professional SDK 版本。
虚拟背景在 tencent_calls_uikit: 2.3.2 (LiteAVSDK_Professional 11.7.0.12001) 开始支持,不同的 LiteAVSDK_Professional SDK 使用不同的模型文件。
Android
iOS
build.gradle文件,指定 TXLiteAVSDK_Professional 版本, 例如指定为 11.7.12001,可根据需求和版本迭代修改。
api "com.tencent.liteav:LiteAVSDK_Professional:11.7.0.12001"
修改您的 Podfile 文件中的依赖,指定 TXLiteAVSDK_Professional 版本, 例如指定为 11.7.12001 ,可根据需求和版本迭代修改。
pod 'TXLiteAVSDK_Professional', '11.7.12001'
3. 根据模型文件与SDK的匹配 情况下载模型文件,并添加到 Android Studio 和 Xcode 工程中。
Android
iOS
解压后将LiteavSegmentModel.zip文件拷贝到 Android 工程中的 assets 目录下。



解压后将LiteavSegmentModel.bundle文件拖拽到您的 Xcode工程中。




开启模糊背景

TUICallKit 的 UI 方案支持设置模糊背景。通过调用以下接口,您可以在 UI 上显示模糊背景的功能按钮,点击按钮可直接启用模糊背景功能。
TUICallKit.instance.enableVirtualBackground(true);

设置图片背景(可选)

图片背景需要用户自行实现,将图片文件添加到 Flutter 工程中(需要在 pubspec.yaml 文件中添加资源), 并调用接口设置背景图片(目前只支持本地路径的图片,网络图片暂时不支持)。
TUICallEngine.instance.setVirtualBackground("***.png", (code, message) { });

常见问题

1. 开启模糊背景无反应或有延迟

确保已购买音视频通话群组通话版(140万分钟)套餐,详见 开通服务
确保已下载模型文件至本地。
如果没有添加模型文件到本地路径中,在开启模糊背景功能的时候,SDK 内部才会去下载模型文件,正常网络情况下,下载耗时1~3s,网络越差耗时越久。
检查模型文件与 SDK 是否匹配。

2. 模型文件与SDK的匹配

TUICallKit 是基于 IM SDK 和 TRTC SDK 实现的音视频通话场景,虚拟背景是 TRTC SDK 提供的特色功能。要注意的是,虚拟背景模型文件与 TRTC SDK 的版本需要匹配,否则可能会导致模糊背景功能无法正常使用。下表列出了模型文件与 TRTC SDK 的对应关系:
SDK版本
虚拟背景模型文件下载地址·
LiteAVSDK_Professional: 11.7.0.12001
下载