设置表情和虚拟形象
美颜特效 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', // 模式设置为VReffectId: avatarARList[0].EffectId// 传内置id}, () => {// success callback});
自定义模型
VR 虚拟形象
获取模型列表
SDK 初始化完成之后即可获取内置的模型列表,目前 SDK 内置了10个虚拟形象。
const avatarVRList = await sdk.getAvatarList('VR')
设置场景
ar.setAvatar({mode: 'VR', // mode传VReffectId: avatarVRList[0].EffectId, // 传内置idbackgroundUrl: '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传VRurl: 'https://xxxx.glb', // 传内置idbackgroundUrl: 'https://webar-static.tencent-cloud.com/assets/background/1.jpg',}, () => {// success callback});
目前自定义模型仅支持 GLB 与 VRM 格式。