> 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 资产上传器**。你将创建一个为 MetaHuman 量身定制的新项目，导入你的 MetaHuman 资源，对其进行配置，最后使用 Convai 内置工具将其上传。 ## 前置条件 在开始之前： * 使用 [**Convai 资产上传器**](/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//`. * 打开蓝图： `BP_` > ⏳ 这可能需要一些时间来加载。 *** ### 4. 修复编译错误 如果你看到编译错误： * 在右下角，点击 **启用缺失项** ，位于任何 **缺失的插件** 或 **缺失的项目设置** 提示下方。
* 点击 **立即重启** ，当系统提示时。 * 重新打开蓝图，并确保它成功编译。 *** ### 5. 为上传准备资源 1. 找到文件夹：\ `Plugins/ Content/`\ （例如， `Plugins/AHK3LNKVC7FZA3I5JG3V Content/`) 2. 将整个 `Content/Metahumans/` 文件夹移动到该目录中。 * 使用 **移到此处** 以完成操作。 * 最终结构应与截图中显示的一致。
{% hint style="info" %} 此文件夹决定哪些内容会被打包并上传。请确保所有内容都放置正确。 {% endhint %} *** ### 6. 打开资产上传器工具 * 导航到 `Content/Editor/AssetUploader`. * 右键单击 `AssetUploader` 并选择 **运行编辑器实用小部件**. *** ### 7. 选择角色资产 * 导航到 `Plugins/ Content/Metahumans//` 目录。 * 选中 `BP_` 蓝图。 * 然后，在 **资产上传器** 窗口中，点击 **选择资产**. *** ### 8. 捕获缩略图 * 在资产上传器窗口中，点击 **捕获缩略图** 为你的头像生成预览图。 *** ### 9. 上传前验证功能 1. 拖拽 `BP_` 到关卡中。 2. 选择角色并找到 `BP_ConvaiChatbotComponent` ，位于 **Details** 面板。 3. 输入一个测试 **角色 ID**. 4. 按 **播放** 并确认： * 动画正常工作 * 口型同步正常 * 角色表现符合预期 {% hint style="info" %} 在上传之前，请查看 [MetaHuman 头发和皮肤外观指南](/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) ，以检查 Avatar Studio 目标渲染配置文件中的发型和材质。 {% endhint %} *** ### 10. 上传头像 * 在资产上传器中，点击 **创建资产**. * 这将： * 将头像打包为 Win64 * 将其上传到 Avatar Studio 监视 **输出日志**: * 查找 `打包完成` * 然后等待 `已上传的资产` {% hint style="warning" %} 如果在打包过程中出现错误，请检查日志并将其分享到 [Convai 开发者论坛](https://forum.convai.com/) 以获取支持。 {% endhint %} {% hint style="info" %} 要删除先前上传的资产，请打开 AssetUploader 并点击 **删除**. {% endhint %} *** ## 性能考量与限制 {% hint style="warning" %} Avatar Studio 具有固定的实时 CPU、GPU 和内存预算。Convai 的示例头像已针对该环境进行了优化，但自定义 MetaHuman 会随你提供的资源和逻辑一起上传。成功上传并不保证托管后的性能流畅。 {% endhint %} 不存在适用于每个角色的单一资源上限。性能取决于头像、动画、背景和自定义行为的综合成本。请审查完整体验： * **头发和发型：** 头发和面部发型在渲染时可能成本很高。仅将发丝、曲线、点和组的复杂度保持在所需外观所要求的水平。移除未使用的发型组件，在不需要的地方禁用模拟，并谨慎使用阴影和材质功能。请参阅 Epic 的 [发型性能指南](https://dev.epicgames.com/documentation/unreal-engine/groom-scalability-and-performance-with-unreal-engine). * **几何体和配件：** 移除隐藏、重复或未使用的几何体和组件。自定义服装、配饰、布料和变形复杂度应与学习者实际能看到的内容相匹配。 * **纹理和材质：** 使用适合预期取景的纹理分辨率，并移除不必要的材质槽或高开销的着色器功能。不要依赖光线追踪或 Lumen 特定的外观；请在托管的光照和渲染设置下检查头发和皮肤材质。 * **蓝图和动画：** 优先使用事件驱动的蓝图行为。避免在 **Event Tick**上进行不必要的工作、每帧搜索或分配，以及在未使用时仍持续 Tick 的组件。将同时运行的动画、物理、控制绑定和程序系统限制为当前交互所需的部分。 * **检查托管体验：** 上传后，通过网站上的 Avatar Studio 使用该体验。检查加载和交互响应速度、动画流畅度、口型同步和音频时序，以及视觉一致性。 如果性能低于预期，请一次简化一个开销较大的功能并重新上传。先从发型开始，然后是几何体、材质、纹理和自定义蓝图效果。 *** ## 访问头像 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 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=&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.