tencent cloud

文档反馈

使用表情和虚拟形象

最后更新时间:2023-04-11 16:32:01
    美颜特效 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 格式。
    联系我们

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

    技术支持

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

    7x24 电话支持