> 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 Asset Uploader**。你将导入 Reallusion 角色及动画，应用 Convai 的动画和口型同步系统，然后使用内置的 AssetUploader 工具将虚拟形象上传到 Avatar Studio。

***

## 前提条件

请确保已准备好以下内容：

* 使用以下工具创建的项目： [**Convai Asset Uploader**](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/asset-uploader.md)，并且在回答“你是否使用 Metahuman？”时选择了 **`N`** 。
* 已导出并可供导入的自定义 Reallusion 角色

***

## 分步指南

### 1. 打开项目

前往项目目录，然后打开 `.uproject` 文件，在 Unreal Engine 中启动项目。

***

### 2. 导入 Reallusion 角色和动画

按照此 [视频教程](https://youtu.be/UyxNliF8LKU?feature=shared) 导入 Reallusion 资源：

* **\[00:00 – 07:25]**: 导入角色和动画
* **\[07:50 – 08:20]**: 为角色创建新的蓝图类

***

### 3. 连接 Convai 动画

现在，我们将为角色绑定正确的动画逻辑。

我们已为你添加所需的动画蓝图：

* 前往 `Content/ConvaiReallusion/`
* 找到并指定 **ConvaiReallusion Animation Blueprint** 作为角色的骨骼网格体动画蓝图

{% hint style="info" %}
此蓝图可确保 Reallusion 角色在与 Convai 交互时，播放恰当的待机/说话动画并保持同步。
{% endhint %}

* 此步骤请参阅 [教程](https://youtu.be/UyxNliF8LKU?feature=shared) ： **\[10:12 – 12:48]**

***

### 4. 添加 FaceSync 以实现口型同步

启用口型同步：

* 将 `FaceSync` 组件添加到角色的蓝图中
* 请观看同一段 [视频](https://youtu.be/UyxNliF8LKU?feature=shared): **\[12:48 – 12:56]**

***

### 5. 设置正确的旋转方向

Reallusion 角色的默认朝向通常不正确。请按以下步骤修正：

* 打开角色蓝图
* 选择 **SkeletalMesh** 组件
* 将 **Z 轴旋转** 设置为 `-90` 在 **细节** 面板中

***

### 6. 准备要上传的文件

1. 前往：\
   `Plugins/<random code> Content/`\
   （例如， `Plugins/AHK3LNKVC7FZA3I5JG3V Content/`)
2. 拖动并 **移动** 以下两个文件夹到此目录中：
   * 角色文件夹（包含蓝图和动画）
   * `Content/ConvaiReallusion/` （包含动画蓝图）
   * 最终目录结构应与截图中所示一致。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fzf59uT7ltyho3f8eFs74%2FScreenshot%202025-04-19%20143603.png?alt=media&amp;token=b62801da-596f-4d15-beea-e7f9e2efd49c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
此文件夹决定要打包和上传的内容。请确保所有文件都放置正确。
{% endhint %}

***

### 7. 打开 AssetUploader 工具

* 导航至 `Content/Editor/AssetUploader`
* 右键单击并选择 **运行编辑器实用工具小部件**

***

### 8. 选择角色资产

* 导航至 `Plugins/<random code> Content/YourCharacterFolder/`
* 选择角色的 **蓝图类**
* 然后，在 Asset Uploader 窗口中，点击 **选择资产**

***

### 9. 捕获缩略图

点击 **捕获缩略图** 以创建预览图像，该图像将显示在 Avatar Studio 中。

***

### 10. 上传前验证

上传前，请快速进行功能测试：

1. 将角色拖入关卡
2. 选中角色并找到 `BP_ConvaiChatbotComponent` 在 **细节** 面板中
3. 粘贴测试用的 **角色 ID**
4. 按下 **播放** 并验证：
   * 动画运行正常
   * 口型同步功能正常
   * 角色的位置和朝向正确

***

### 11. 上传头像

* 在 Asset Uploader 中，点击 **创建资产**
* 此操作会：
  * 为以下平台打包资产： **Win64**
  * 上传到 **Avatar Studio**

监视 **输出日志**:

* 等待 `Package completed`
* 然后查找 `Uploaded Asset`

{% 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 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=<question>&goal=<user_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.
