tencent cloud

腾讯特效 SDK

动态与公告
产品动态
关于腾讯特效 SDK V3.5 版本更新公告
关于腾讯特效 SDK V3.0 版本相关接口及素材变更公告
产品简介
产品概述
产品功能
基本概念
产品优势
应用场景
购买指南
价格总览
购买流程
欠费退费说明
新手指引
Demo 体验
免费测试
License 指引
移动端 License 新增与续期
PC 端 License 新增与续期
Web端 License 新增与续期
常见问题
SDK 下载
功能说明
SDK 下载
版本历史
SDK 集成指引(无 UI)
通用集成腾讯特效
原子能力集成指引
SDK 集成指引(含 UI)
通用集成腾讯特效
直播 SDK 集成腾讯特效
TRTC SDK 集成腾讯特效
短视频 SDK 集成腾讯特效
Avatar 虚拟人集成指引
API 文档
iOS
Android
Flutter
Web
功能实践
SDK 包瘦身
SDK 集成问题排查
性能调优
效果调优
素材使用
美颜参数说明
美颜场景推荐参数
短视频企业版迁移指引
第三方推流接入美颜(Flutter)
小程序美颜特效实践
素材制作工具使用
Web 美颜特效
产品概述
快速上手
SDK 接入
API 文档
控制台指南
Demo 体验
内置素材总览
实践教程
常见问题
常见问题
通用类相关
技术类相关
License 相关
旧版文档
美颜场景推荐参数
美颜参数表
一分钟集成 TRTC
一分钟集成直播
TE SDK 政策
隐私协议
数据处理和安全协议
联系我们

使用人像分割(虚拟背景)

PDF
聚焦模式
字号
最后更新时间: 2025-12-05 10:46:13
实现虚拟背景需要在初始化时启用人像分割模块,详情请参见 自定义流内置相机

设置背景

SDK 支持设置模糊背景、图片背景,支持在初始化参数中透传:
const config = {
module: {
beautify: true, // 是否启用美颜模块,启用后可以使用美颜、美妆、贴纸等功能
segmentation: true // 是否启用人像分割模块,启用后可以使用背景功能
segmentationLevel: 0 // 1.0.19 及以上版本开始支持切换背景分割模型
},
auth: authData, // 鉴权参数
input: stream, // input传输入流
beautify: { // 初始化美颜参数(可选)
whiten: 0.1,
dermabrasion: 0.3,
eye: 0.2,
chin: 0,
lift: 0.1,
shave: 0.2
},
background: {
type: 'blur' // 模糊背景
}
}
const sdk = new ArSdk(
// 传入一个 config 对象用于初始化 sdk
config
)
SDK 也支持修改背景:
sdk.setBackground({
type: 'image', // 图片背景
src: 'https://webar-static.tencent-cloud.com/assets/background/1.jpg'
})
SDK 支持 video 类型动态背景(1.0.23 版本开始支持):
sdk.setBackground({
type: 'video', // 视频动态背景
src: 'https://webar-static.tencent-cloud.com/assets/background/video-bg-1.mp4',
})

透明背景

SDK 在部分浏览器中支持透明背景:
sdk.setBackground({
type: 'transparent'
})
注意:
由于浏览器的兼容性问题,请注意以下几点:
人像分割同时支持移动端及桌面端浏览器。
仅能在本地处理并展示透明背景,WebRTC 不支持编码透明通道,推流会使透明背景失效。
透明背景效果仅支持桌面端的 Chrome/Firefox,桌面端 Safari 及 iOS 端均不支持。
1.0.19 及以上版本开始支持切换背景分割模型,参数支持:0、1、2。
level 0 的性能最好,但分割效果相对一般。
level 1 的效果和性能均适中。
level 2的分割效果最好,推理耗时最长,适合对分割效果要求高且硬件性能较好的场景。


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈