Docs Overview/
Call/
Web/
高级功能/
虚拟背景/

虚拟背景

TUICallKit 推出了虚拟背景新特性，让用户在视频通话时，可设置模糊背景或图片背景，隐藏真实通话环境，保护隐私，让通话更有趣。 接下来，本文将详细介绍在 TUICallKit 组件中如何使用这一特性。

集成效果

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










准备条件

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

开启模糊背景

TUICallKit 的 UI 方案支持设置模糊背景。通过调用以下接口，您可以在 UI 上显示模糊背景的功能按钮，点击按钮可直接启用模糊背景功能。
注意：
H5 暂不支持，仅 PC 支持。
TUICallKit v3.2.4+ 支持。
import { TUICallKitServer } from "@tencentcloud/call-uikit-vue"; // take @tencentcloud/call-uikit-vue for example
TUICallKitServer.enableVirtualBackground(true);

设置图片背景（可选）

图片背景需要用户自行实现，将图片保存在本地后，调用以下接口进行设置。网络图片也支持。
import { TUICallKitServer } from "@tencentcloud/call-uikit-vue"; // take @tencentcloud/call-uikit-vue for example
TUICallKitServer.getTUICallEngineInstance().setVirtualBackground(imagePath: string)

常见问题

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

确保已购买音视频通话 Group Call套餐，详见 开通服务。
网络较差时，虚拟背景模型文件可能未下载完，从而导致开启虚拟背景失败。

关闭摄像头，是否能开启虚拟背景？

不能。