换装和捏脸

在虚拟场景中，塑造一个独一无二的虚拟形象是进入场景的第一步。元语聊支持导入自定义人物素材模型，并支持换装和捏脸功能。本文介绍如何在元语聊中实现对虚拟形象的换装和捏脸。

示例项目

声网在 GitHub 上提供开源 Agora-MetaChat 示例项目供你参考使用。如果你还需了解 Unity 部分的工程文件和功能指南，请联系 sales@agora.io 获取。

前提条件

实现换装和捏脸前，请确保你已实现基础的元语聊功能，如创建、进入 3D 场景、创建虚拟形象。详见客户端实现。

实现步骤

本节展示如何实现换装，内容以 Native 部分的开发为主，Unity 部分的开发请参考 Unity 工程文件和功能指南。捏脸的功能实现也请参考 Unity 工程文件。

下图展示 API 调用时序：

1. 更换装扮

建议在业务逻辑中包含多个场景的情况下，调用 enterScene 时使用 EnterSceneConfig 中的 mExtraCustomInfo 来设置 sceneIndex，以便区分不同的场景。Unity 场景脚本可以根据 sceneIndex 来确定进入哪个场景，并执行相应的逻辑。

在这种情况下，我们将 sceneIndex 设置为“换装”场景，这些场景只包含待更换装扮的用户，没有其他用户。因此，在这些场景中，只需要更换装扮。你可以通过 IMetachatScene 的 sendMessageToScene 方法向 Unity 场景发送自定义的换装消息。Unity 场景脚本可以处理对应的自定义消息，实现人物装扮的更换。

// 本节代码展示换装的逻辑
// 自定义 UnityMessage 实体类
// UnityMessage 包含 key 和 value 属性
UnityMessage message = new UnityMessage();
// 设置 key
message.setKey("dressSetting");
// 设置 value
message.setValue(JSONObject.toJSONString(getUnityRoleInfo()));
// 将 UnityMessage 实体类转换成 JSON 字符串
String msg = JSONObject.toJSONString(message);

// 将 UnityMessage 字符串转换成字节数组并发送到场景中
metaChatScene.sendMessageToScene(msg.getBytes());

2. 同步装扮

更换人物装扮后，如果用户需进入其他场景并让其他用户看到新形象，则需要同步更换的装扮信息。你可以通过 ILocalUserAvatar 的 setDressInfo 方法让 SDK 将更新后的形象同步给场景中的其他用户。

// 本节代码展示同步装扮的逻辑
// 设置用户信息
localUserAvatar.setUserInfo(userInfo);
// 设置本地用户的模型信息
// model 对应的资源包类型为 2(BUNDLE_TYPE_AVATAR)
localUserAvatar.setModelInfo(modelInfo);
if (null != roleInfo) {
    DressInfo dressInfo = new DressInfo();
    // mExtraCustomInfo 是额外的自定义信息
    // getUnityRoleInfo 代表 Unity 场景的角色信息
    // 将 mExtraCustomInfo 设置为 getUnityRoleInfo 方法获取的 JSON 字节数组
    dressInfo.mExtraCustomInfo = (JSONObject.toJSONString(getUnityRoleInfo())).getBytes();
    // 设置本地用户的服装信息
    localUserAvatar.setDressInfo(dressInfo);
}