> 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/metahuman-avatars.md).

# Metahuman 头像

## 简介

本指南将带你完成上传 **自定义 Metahuman 头像** 到 **Avatar Studio** 使用 **Convai 资源上传器**. 你将创建一个专为 Metahuman 设计的新项目，导入你的 Metahuman 资源，进行配置，最后使用 Convai 内置工具将其上传。

## 先决条件

开始之前：

* 使用以下工具创建你的项目： [**Convai 资源上传器**](/api-docs/zh/asset-uploader.md)，并回答 **`Y`** 当被问到你是否在使用 Metahuman 时。
* 确保你已通过以下方式获得可下载的 Metahuman： **Quixel Bridge**.

***

## 分步指南

### 1. 打开项目

前往项目创建所在的文件夹。双击 `YourProjectName.uproject` 文件，以在 Unreal Engine 中打开它。

***

### 2. 通过 Quixel Bridge 添加 Metahuman

* 前往 **窗口 > Quixel Bridge**.
* 在 Bridge 中，选择 **Metahumans** ，在左侧菜单中。
* 选择一个 Metahuman 并点击：
  * **下载** （如果尚未下载）
  * 然后 **添加** 将其添加到你的项目中。

***

### 3. 定位并打开角色蓝图

导入后：

* 前往 `Content/Metahumans/<CharacterName>/`.
* 打开该蓝图： `BP_<CharacterName>`

  > ⏳ 这可能需要一些时间来加载。

***

### 4. 修复编译错误

如果你看到编译错误：

* 在右下角，点击 **启用缺失项** 在任何 **缺失插件** 或 **缺失的项目设置** 提示下。

<figure><img src="/files/44adf66237dac647a79c76997057c222852ae984" alt=""><figcaption></figcaption></figure>

* 单击 **立即重启** ，在提示时。
* 重新打开蓝图，并确保其成功编译。

***

### 5. 准备资源以供上传

1. 找到以下文件夹：\
   `Plugins/<随机代码> Content/`\
   （例如， `Plugins/AHK3LNKVC7FZA3I5JG3V Content/`)
2. 将整个 `Content/Metahumans/` 文件夹移动到此目录。
   * 使用 **移到这里** 以完成操作。
   * 最终结构应与截图中显示的一致。

<figure><img src="/files/dee9a1dcf6d85c7c1cca8b86d043ce7656333b5f" alt=""><figcaption></figcaption></figure>

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

***

### 6. 打开资源上传器工具

* 导航到 `Content/Editor/AssetUploader`.
* 右键点击 `AssetUploader` 并选择 **运行编辑器实用程序小部件**.

***

### 7. 选择角色资源

* 前往 `Plugins/<随机代码> Content/Metahumans/<CharacterName>/` 目录。
* 选择 `BP_<CharacterName>` 蓝图。
* 然后，在 **资源上传器** 窗口中，点击 **选择资源**.

***

### 8. 捕获缩略图

* 在资源上传器窗口中，点击 **捕获缩略图** 为你的头像生成预览图。

***

### 9. 上传前验证功能

1. 拖动 `BP_<CharacterName>` 到关卡中。
2. 选择角色并找到 `BP_ConvaiChatbotComponent` 在 **Details** 面板。
3. 输入一个测试 **角色 ID**.
4. 按 **播放** 并确认：
   * 动画正常工作
   * 口型同步正常
   * 角色表现符合预期

***

### 10. 上传头像

* 在资源上传器中，点击 **创建资源**.
* 这将：
  * 将头像打包为 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. 你的 Metahuman 将出现，并可立即使用。

***

## 总结

使用 Convai 资源上传器，上传自定义 Metahuman 头像既快捷又可靠。只需正确设置并点击几下，你的角色就会在 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/metahuman-avatars.md?ask=<question>
```

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.