# 换装和捏脸 (/zh-CN/solutions/meta-world/build/dress-face) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). <_PlatformTabsGroup> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" /> 在虚拟场景中,塑造一个独一无二的虚拟形象是进入场景的第一步。MetaWorld 支持导入自定义人物素材模型,并支持换装和捏脸功能。本文介绍如何在 MetaWorld 中实现对虚拟形象的换装和捏脸。 ## 示例项目 [#示例项目] 声网在 GitHub 上提供开源 [Agora-MetaWorld](https://github.com/AgoraIO-Community/Agora-MetaWorld/tree/dev_metasdk1.0) 示例项目供你参考。 如果你还需了解 Unity 部分的工程文件和功能指南,请联系 sales@shengwang.cn 获取。 ## 前提条件 [#前提条件] 实现该进阶功能前,请确保你已实现基础的元语聊或元直播功能,如创建 Meta 服务、获取并下载场景资源、创建场景、设置虚拟形象的信息并进入场景。详见[基础功能](/zh-CN/solutions/meta-world/build/metachat)。 ## 实现步骤 [#实现步骤] 下图展示 API 调用时序: ### 1 解压资源并设置 UI [#1-解压资源并设置-ui] 解压用于换装和捏脸的资源压缩包,并根据下载的资源文件显示特定的 UI。 ```java // 解压换装捏脸资源 // 如下只是示例,你可以根据自己的开发环境自行实现解压 private void unzipIcons(String filePath) { // 创建目标文件夹路径,用于存储解压后的文件 File targetFolderPath = new File(filePath + File.separator + FILE_NAME_ICON_FOLDER); if (targetFolderPath.exists()) { Utils.deleteFile(targetFolderPath); } // 调用 unzip 方法解压 icon 资源压缩包 Utils.unzip(filePath + File.separator + FILE_NAME_ICONS_ZIP, filePath); } // unzip 方法的实现 // 通过系统原生的 ZipInputStream 类和 FileOutputStream 类实现 unzip 方法 // 用于解压 icon 资源压缩包 public static void unzip(String zipFilePath, String destDirectory) { File destDir = new File(destDirectory); if (!destDir.exists()) { destDir.mkdir(); } try (ZipInputStream zipInputStream = new ZipInputStream(new FileInputStream(zipFilePath));) { ZipEntry zipEntry = zipInputStream.getNextEntry(); byte[] buffer = new byte[1024]; while (zipEntry != null) { if (!zipEntry.isDirectory()) { String fileName = zipEntry.getName(); File newFile = new File(destDirectory + File.separator + fileName); // create all non exists folders new File(newFile.getParent()).mkdirs(); FileOutputStream fileOutputStream = new FileOutputStream(newFile); int len; while ((len = zipInputStream.read(buffer)) > 0) { fileOutputStream.write(buffer, 0, len); } fileOutputStream.close(); } zipEntry = zipInputStream.getNextEntry(); } zipInputStream.closeEntry(); } catch (Exception e) { e.printStackTrace(); } } private void setupUI() { // 根据下载的资源文件显示特定的 UI ...... } ``` ### 2 发送换装和捏脸消息 [#2-发送换装和捏脸消息] 通过 [`sendSceneMessage`](/zh-CN/solutions/meta-world/reference/meta-api#sendscenemessage) 方法向虚拟场景中发送用户虚拟角色的换装和捏脸消息。 ```java public static final String KEY_UNITY_MESSAGE_UPDATE_DRESS = "updateDress"; public static final String KEY_UNITY_MESSAGE_UPDATE_FACE = "updateFace"; // 发送换装消息到虚拟场景中 public void sendRoleDressInfo(int[] resIdArray) { // 注意:message 协议格式需要由你们的 Unity 开发人员和 Native 开发人员协商后规定 UnityMessage message = new UnityMessage(); message.setKey(MetaConstants.KEY_UNITY_MESSAGE_UPDATE_DRESS); JSONObject valueJson = new JSONObject(); valueJson.put("id", resIdArray); message.setValue(valueJson.toJSONString()); sendSceneMessage(JSONObject.toJSONString(message)); } // 发送捏脸消息到虚拟场景中 public void sendRoleFaceInfo(FaceParameterItem[] faceParameterItems) { // 注意:message 协议格式需要由你们的 Unity 开发人员和 Native 开发人员协商后规定 UnityMessage message = new UnityMessage(); message.setKey(MetaConstants.KEY_UNITY_MESSAGE_UPDATE_FACE); JSONObject valueJson = new JSONObject(); valueJson.put("value", faceParameterItems); message.setValue(valueJson.toJSONString()); sendSceneMessage(JSONObject.toJSONString(message)); } // 发送消息到虚拟场景中 public void sendSceneMessage(String msg) { if (metaScene == null) { Log.e(TAG, "sendMessageToScene metaScene is null"); return; } if (metaScene.sendSceneMessage(msg.getBytes()) == 0) { Log.i(TAG, "send " + msg + " successful"); } else { Log.e(TAG, "send " + msg + " fail"); } } ``` <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" /> 在虚拟场景中,塑造一个独一无二的虚拟形象是进入场景的第一步。MetaWorld 支持导入自定义人物素材模型,并支持换装和捏脸功能。本文介绍如何在 MetaWorld 中实现对虚拟形象的换装和捏脸。 ## 示例项目 [#示例项目-1] 声网在 GitHub 上提供开源 [Agora-MetaWorld](https://github.com/AgoraIO-Community/Agora-MetaWorld/tree/dev_metasdk1.0) 示例项目供你参考。 如果你还需了解 Unity 部分的工程文件和功能指南,请联系 sales@shengwang.cn 获取。 ## 前提条件 [#前提条件-1] 实现换装和捏脸前,请确保你已实现基础的元语聊或元直播功能,如创建 Meta 服务、获取并下载场景资源、创建场景、设置虚拟形象的信息并进入场景。详见[基础功能](/zh-CN/solutions/meta-world/build/metachat)。 ## 实现步骤 [#实现步骤-1] 下图展示 API 调用时序: ### 1 解压资源并设置 UI [#1-解压资源并设置-ui-1] 解压用于换装和捏脸的资源压缩包,并根据下载的资源文件显示特定的 UI。 ### 2 发送换装和捏脸消息 [#2-发送换装和捏脸消息-1] 通过 [`sendSceneMessage`](/zh-CN/solutions/meta-world/reference/meta-api#sendscenemessage) 方法向虚拟场景中发送用户虚拟角色的换装和捏脸消息。 ```swift private let UPDATE_DRESS = "updateDress" let dic = ["id": [10002]] let data = try? JSONSerialization.data(withJSONObject: dic, options: []) let str = String(data: data!, encoding: String.Encoding.utf8) let sendDic = [ "key": UPDATE_DRESS, "value": str as Any ] as [String : Any] // 注意:message 协议格式需要由你们的 Unity 开发人员和 Native 开发人员协商后规定 if let message = try? JSONSerialization.data(withJSONObject:sendDic, options: .fragmentsAllowed) { // 发送换装消息到虚拟场景中 metaScene?.sendMessage(message) } private let UPDATE_FACE = "updateFace" let dic = ["value": [["key": "EB_updown_1", "value": value]]] let data = try? JSONSerialization.data(withJSONObject: dic, options: []) let str = String(data: data!, encoding: String.Encoding.utf8) let sendDic = [ "key": UPDATE_FACE, "value": str as Any ] as [String : Any] // 注意:message 协议格式需要由你们的 Unity 开发人员和 Native 开发人员协商后规定 if let message = try? JSONSerialization.data(withJSONObject:sendDic, options: .fragmentsAllowed) { // 发送捏脸消息到虚拟场景中 metaScene?.sendMessage(message) } ``` <_PlatformProcessedMarker close="true" />