> 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 头像
## 简介
本指南将说明如何准备和上传 **基于 Reallusion 的头像** 使用 **Convai 资源上传器**。你将导入你的 Reallusion 角色和动画，应用 Convai 的动画和唇形同步系统，然后使用内置的 AssetUploader 工具将头像上传到 Avatar Studio。
***
## 先决条件
请确保你已准备好以下内容：
* 一个使用以下工具创建的项目 [**Convai 资源上传器**](/api-docs/zh/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 动画蓝图** 到你的角色的 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 Asset Uploader，上传 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
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=
```
The question should be specific, self-contained, and written in natural language.
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.