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-04-02 16:47:57
美颜特效 SDK 从0.3.0版本支持 Animoji 表情和 VR 虚拟形象功能。

检测是否支持

Animoji 表情和 VR 虚拟形象仅可在支持 WebGL2 的环境下使用,SDK 提供了检测的静态方法以供判断。
import {ArSdk} from 'tencentcloud-webar'
if (ArSdk.isAvatarSupported()) {
// 初始化相关功能

} else {
alert('当前浏览器不支持虚拟形象')
// 隐藏相关功能
}

Animoji 表情

获取模型列表

SDK 初始化完成之后即可获取内置的模型列表,目前 SDK 内置了4个表情头像。
const avatarARList = await sdk.getAvatarList('AR')
注意:
设置 Animoji 表情与虚拟形象会自动清除美妆、贴纸等效果,同理设置美妆与贴纸会清除表情或虚拟形象效果。

设置模型

拿到列表之后可以通过 EffectId 设置 Animoji 表情效果。
ar.setAvatar({
mode: 'AR', // 模式设置为VR
effectId: avatarARList[0].EffectId// 传内置id
}, () => {
// success callback

});

自定义模型

如有自定义模型的要求请 联系我们

VR 虚拟形象

获取模型列表

SDK 初始化完成之后即可获取内置的模型列表,目前 SDK 内置了10个虚拟形象。
const avatarVRList = await sdk.getAvatarList('VR')

设置场景


ar.setAvatar({
mode: 'VR', // mode传VR
effectId: avatarVRList[0].EffectId, // 传内置id
backgroundUrl: 'https://webar-static.tencent-cloud.com/assets/background/1.jpg',
}, () => {
// success callback


});
注意:
设置 VR 场景需要同步设置背景图片 URL,缺省则默认为黑色背景。

自定义模型

有两种方式可以快速定制自己的虚拟形象并直接在 SDK 中进行使用。
方式一:readyplayer.me
方式二:Vroid
两种方式导出的模型需自行上传至 CDN,使用 URL 设置 SDK。
ar.setAvatar({
mode: 'VR', // mode传VR
url: 'https://xxxx.glb', // 传内置id
backgroundUrl: 'https://webar-static.tencent-cloud.com/assets/background/1.jpg',
}, () => {
// success callback

});
目前自定义模型仅支持 GLB 与 VRM 格式。

帮助和支持

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

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

文档反馈