设置表情和虚拟形象

美颜特效 SDK 从0.3.0版本支持 Animoji 表情和 VR 虚拟形象功能。
注意:
Animoji 表情和虚拟形象暂不支持小程序。

检测是否支持

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 格式。