> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/avatar-studio-experiences/customizing-your-avatar/configure-avatar/uploading-avatars/reallusion-avatars.md). # Reallusion 头像 使用 Convai 资产上传器将 Unreal Engine 中的自定义 Reallusion 角色上传到 Avatar Studio。 ## 简介 本指南说明如何准备和上传 **基于 Reallusion 的虚拟形象** 使用 **Convai 资源上传器**。你将导入你的 Reallusion 角色和动画，应用 Convai 的动画和唇形同步系统，然后使用内置的 AssetUploader 工具将你的虚拟形象上传到 Avatar Studio。 *** ## 前置条件 请确保你已准备好以下内容： * 一个使用以下内容创建的项目 [**Convai 资源上传器**](/api-docs/zh/cha-jian-yu-ji-cheng/asset-uploader.md)，在其中你回答了 **`N`** “你是否在使用 Metahuman？” * 一个自定义的 Reallusion 角色，已导出并可供导入 *** ## 分步指南 ### 1. 打开项目 前往你的项目目录并打开 `.uproject` 文件以在 Unreal Engine 中启动它。 *** ### 2. 导入 Reallusion 角色和动画 请按照此 [视频教程](https://youtu.be/UyxNliF8LKU?feature=shared) 导入你的 Reallusion 资源： * **\[00:00 – 07:25]**：导入你的角色和动画 * **\[07:50 – 08:20]**：为你的角色创建一个新的 Blueprint 类 *** ### 3. 连接 Convai 动画 现在我们将把正确的动画逻辑绑定到你的角色上。 我们已经为你添加了所需的 Animation Blueprint： * 前往 `Content/ConvaiReallusion/` * 找到并分配 **ConvaiReallusion Animation Blueprint** 到你角色的 Skeletal Mesh {% hint style="info" %} 这个蓝图可确保你的 Reallusion 角色在与 Convai 交互时播放正确的待机/对话动画。 {% endhint %} * 请参考 [教程](https://youtu.be/UyxNliF8LKU?feature=shared) 完成此步骤： **\[10:12 – 12:48]** *** ### 4. 添加 FaceSync 以实现唇形同步 要启用唇形同步： * 添加 `FaceSync` 组件到你的角色 Blueprint 中 * 可在同一个 [视频](https://youtu.be/UyxNliF8LKU?feature=shared): **\[12:48 – 12:56]** *** ### 5. 设置正确的旋转方向 Reallusion 角色默认通常会朝向错误的方向。可通过以下方式修正： * 打开角色 Blueprint * 选择 **SkeletalMesh** 组件 * 将 **Z 轴旋转** 为 `-90` ，位于 **Details** 面板 *** ### 6. 准备上传文件 1. 前往：\ `Plugins/ Content/`\ （例如， `Plugins/AHK3LNKVC7FZA3I5JG3V Content/`) 2. 拖动并 **移动** 以下两个文件夹到该目录中： * 你角色的文件夹（包含 Blueprint 和动画） * `Content/ConvaiReallusion/` （包含动画蓝图） * 最终结构应与截图中的内容一致。
{% hint style="info" %} 此文件夹决定哪些内容会被打包并上传。请确保一切放置正确。 {% endhint %} *** ### 7. 打开 AssetUploader 工具 * 导航到 `Content/Editor/AssetUploader` * 右键单击并选择 **运行编辑器实用小组件** *** ### 8. 选择角色资源 * 导航到 `Plugins/ Content/YourCharacterFolder/` * 选择你角色的 **Blueprint 类** * 然后在 Asset Uploader 窗口中点击 **选择资源** *** ### 9. 捕获缩略图 点击 **捕获缩略图** 以创建一张将在 Avatar Studio 中显示的预览图。 *** ### 10. 上传前验证 在上传前，请先进行一次快速功能测试： 1. 将角色拖入你的关卡 2. 选中它并找到 `BP_ConvaiChatbotComponent` ，位于 **Details** 面板 3. 粘贴一段测试 **角色 ID** 4. 按 **播放** 并验证： * 动画正常工作 * 唇形同步正常运行 * 角色的位置和朝向正确 *** ### 11. 上传虚拟形象 * 在 Asset Uploader 中，点击 **创建资源** * 这会触发： * 将资源打包为 **Win64** * 上传到 **Avatar Studio** 监视 **输出日志**: * 等待 `打包完成` * 然后查找 `已上传的资源` {% hint style="warning" %} 如果打包过程中出现错误，请检查日志并将其分享到 [Convai 开发者论坛](https://forum.convai.com/) 以获取支持。 {% endhint %} {% hint style="info" %} 要删除之前上传的资源，请打开 AssetUploader 并点击 **删除**. {% endhint %} *** ## 访问虚拟形象 1. 访问 [Avatar Studio](https://convai.com/) 2. 前往 **上传你的自定义虚拟形象** 3. 你的 Reallusion 角色现在将可供选择和使用 *** ## 总结 使用 Convai 资源上传器，上传 Reallusion 虚拟形象既快速又可靠。只需正确设置并点击几下，你的角色就能在 Avatar Studio 中上线，并可进行实时 AI 交互。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/avatar-studio-experiences/customizing-your-avatar/configure-avatar/uploading-avatars/reallusion-avatars.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.