> 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 头像

使用 Convai 资产上传器将 Unreal Engine 中的自定义 MetaHuman 角色上传到 Avatar Studio。

## 简介

本指南将引导你上传 **自定义 Metahuman 虚拟人** 到 **Avatar Studio** 使用 **Convai Asset Uploader**。你将创建一个专为 Metahuman 定制的新项目，导入 Metahuman 资源并进行配置，最后使用 Convai 内置工具上传。

## 前提条件

开始之前：

* 使用 [**Convai Asset Uploader**](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/asset-uploader.md)创建项目，并在系统询问你是否使用 Metahuman 时回答 **`Y`** 。
* 确保你已通过 **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="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FPGbyMAYA7w4tL6ymhDby%2FScreenshot%202025-04-18%20224336.png?alt=media&amp;token=0d776a88-d1e4-4bde-9315-9c0ea0d17e22" alt=""><figcaption></figcaption></figure>

* 出现提示时，点击 **立即重启** 。
* 重新打开蓝图，并确保它能成功编译。

***

### 5. 准备要上传的资产

1. 找到此文件夹：\
   `Plugins/<random code> Content/`\
   （例如， `Plugins/AHK3LNKVC7FZA3I5JG3V Content/`)
2. 将整个 `Content/Metahumans/` 文件夹移动到此目录中。
   * 选择 **在此处移动** 以完成此操作。
   * 最终目录结构应与截图所示一致。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FCc1iimc3DM3WggkxB6zp%2FScreenshot%202025-04-18%20231010.png?alt=media&amp;token=fb310253-405f-4a35-8062-c3ed7df33425" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
此文件夹决定了哪些内容会被打包并上传。请确保所有内容都放置正确。
{% endhint %}

***

### 6. 打开资产上传工具

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

***

### 7. 选择角色资产

* 导航到 `Plugins/<random code> Content/Metahumans/<CharacterName>/` 目录。
* 选择 `BP_<CharacterName>` 蓝图。
* 然后，在 **资产上传工具** 窗口中，点击 **选择资产**.

***

### 8. 捕获缩略图

* 在资产上传工具窗口中，点击 **捕获缩略图** 为你的虚拟形象生成预览图。

***

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

1. 将 `BP_<CharacterName>` 拖入关卡。
2. 选择角色并在 `BP_ConvaiChatbotComponent` 组件的 **细节** 面板中找到它。
3. 输入一个测试用 **角色 ID**.
4. 按下 **播放** 并确认：
   * 动画正常运行
   * 口型同步功能正常
   * 角色表现符合预期

{% hint style="info" %}
上传前，请查看 [MetaHuman 头发和皮肤外观指南](https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/avatar-studio-experiences/customizing-your-avatar/configure-avatar/uploading-avatars/metahuman-avatars/metahuman-hair-and-skin-appearance-guidelines.md) 以检查 Groom 和材质在 Avatar Studio 目标渲染配置下的效果。
{% endhint %}

***

### 10. 上传 Avatar

* 在 Asset Uploader 中，点击 **创建资产**.
* 这将：
  * 将 Avatar 打包为 Win64 版本
  * 将其上传到 Avatar Studio

监控 **输出日志**:

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

{% hint style="warning" %}
如果打包过程中出错，请检查日志并将其发布到 [Convai 开发者论坛](https://forum.convai.com/) 寻求支持。
{% endhint %}

{% hint style="info" %}
若要删除之前上传的资产，请打开 AssetUploader 并点击 **删除**.
{% endhint %}

***

## 性能注意事项与限制

{% hint style="warning" %}
Avatar Studio 的实时 CPU、GPU 和内存预算是固定的。Convai 的示例 Avatar 已针对该环境进行优化，但自定义 MetaHuman 会连同您提供的资产和逻辑一起上传。上传成功并不意味着托管环境中的运行一定流畅。
{% endhint %}

没有适用于所有角色的统一资产限制。性能取决于 Avatar、动画、背景和自定义行为的综合开销。请检查完整体验：

* **头发和 Groom：** 头发和面部 Groom 的渲染开销可能很高。请根据预期外观，合理控制发丝、曲线、点和组的复杂度。移除未使用的 Groom 组件，在不需要时禁用模拟，并谨慎使用阴影和材质功能。请参阅 Epic 的 [Groom 性能指南](https://dev.epicgames.com/documentation/unreal-engine/groom-scalability-and-performance-with-unreal-engine).
* **几何体和配件：** 移除隐藏、重复或未使用的几何体和组件。自定义服装、配件、布料和变形的复杂度，应与学习者实际能看到的内容相匹配。
* **纹理和材质：** 根据预期的取景范围选择合适的纹理分辨率，并移除不必要的材质槽或开销较大的着色器功能。不要依赖光线追踪或 Lumen 专属的外观效果；请在托管环境的灯光和渲染设置下检查头发和皮肤材质。
* **蓝图和动画：** 优先采用事件驱动的蓝图行为。避免不必要的 **Event Tick**、逐帧搜索或内存分配，以及在不使用时仍持续运行 Tick 的组件。仅启用当前交互所需的动画、物理、控制绑定和程序化系统，并限制其同时运行的数量。
* **检查托管环境中的体验：** 上传后，通过网站上的 Avatar Studio 使用该体验。检查加载和交互响应速度、动画流畅度、口型同步与音频的时序，以及视觉效果的一致性。

如果性能低于预期，请每次简化一个开销较大的功能，然后重新上传。优先从 Groom 入手，其次检查几何体、材质、纹理和自定义蓝图效果。

***

## 访问 Avatar

1. 前往 [Avatar Studio](https://convai.com/)
2. 打开 **上传您的自定义 Avatar** 部分
3. 您的 MetaHuman 将会显示出来，随时可供使用。

***

## 总结

使用 Convai Asset Uploader 上传自定义 MetaHuman Avatar，过程快速而可靠。只需正确设置并点击几下，您的角色即可在 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/metahuman-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.
