tencent cloud

文档反馈

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

    集成效果

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

    准备条件

    1. 在使用腾讯云提供的虚拟背景功能前,您需要前往控制台,为应用开通音视频服务,并购买群组通话版套餐,具体步骤请参见 开通服务。
    2. 下载 虚拟背景模型 文件,解压后将LiteavSegmentModel.bundle文件拖拽到您的工程中,并确保它在MainBundle中。
    
    
    
    3. 修改您的 Podfile 文件中的依赖,替换为 Professional 版本,并指定 TXLiteAVSDK_Professional 版本为 11.8.15669
    pod 'TUICallKit_Swift/Professional'
    pod 'TXLiteAVSDK_Professional', '11.8.15669'
    注意:
    TRTC SDK 的版本与模型文件间有对应关系,请确保版本号与模型相匹配,详见下方:模型文件与SDK的匹配

    开启模糊背景

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

    设置图片背景(可选)

    图片背景需要用户自行实现,将图片保存在本地后,调用以下接口进行设置(目前只支持本地路径的图片,网络图片暂时不支持)。
    import TUICallEngine
    
    TUICallEngine.createInstance().setVirtualBackground("imagePath") { code, message in
    }

    常见问题

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

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

    模型文件与 SDK 的匹配?

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

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持