即时通信 IM Flutter（虚拟背景）

一、集成效果

TUICallKit 组件接入虚拟背景功能后的显示效果如下：

二、准备条件

1. 在使用腾讯云提供的虚拟背景功能前，你需要前往控制台，为应用开通音视频服务，购买群组通话版（140万分钟）套餐。具体步骤请参见 开通服务。

2. 指定 LiteAVSDK_Professional SDK 版本。

虚拟背景在 tencent_calls_uikit: 2.3.2 (LiteAVSDK_Professional 11.7.0.12001) 开始支持，不同的 LiteAVSDK_Professional SDK 使用不同的模型文件。

AndroidiOS在build.gradle文件，指定 TXLiteAVSDK_Professional 版本， 例如指定为 11.8.0.14176，可根据需求和版本迭代修改。api "com.tencent.liteav:LiteAVSDK_Professional:11.8.0.14176"修改你的 Podfile 文件中的依赖，指定 TXLiteAVSDK_Professional 版本， 例如指定为 11.8.15669，可根据需求和版本迭代修改。pod 'TXLiteAVSDK_Professional', '11.8.15669'

3. 根据 模型文件与 SDK 的匹配 情况下载模型文件，并添加到 Android Studio 和 Xcode 工程中。

AndroidiOS解压后将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 的对应关系：