> 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 Asset Uploader**。你将为 MetaHuman 创建一个新的项目，导入你的 MetaHuman 资源，对其进行配置，最后使用 Convai 内置工具将其上传。 ## 前提条件 开始之前： * 使用 [**Convai Asset Uploader**](/api-docs/zh/cha-jian-yu-ji-cheng/asset-uploader.md)创建你的项目，并在被问到你是否使用 MetaHuman 时回答 **`Y`** 。 * 确保你有可通过 **Quixel Bridge**. *** ## 获得的可下载 MetaHuman ### 1. 打开项目 导航到你的项目创建所在文件夹。双击 `YourProjectName.uproject` 文件，在 Unreal Engine 中打开它。 *** ### 2. 通过 Quixel Bridge 添加 MetaHuman * 前往 **Window > Quixel Bridge**. * 在 Bridge 中，从左侧菜单选择 **Metahumans** 。 * 选择一个 MetaHuman 并点击： * **Download** （如果尚未下载） * 然后 **Add** 将其添加到你的项目中。 *** ### 3. 定位并打开角色蓝图 导入后： * 前往 `Content/Metahumans//`. * 打开蓝图： `BP_` > ⏳ 这可能需要一些时间加载。 *** ### 4. 修复编译错误 如果你看到编译错误： * 在右下角，点击 **Enable Missing** 下方任意 **Missing Plugins** 或 **Missing Project Settings** 提示中的。
* 点击 **Restart Now** ，当系统提示时。 * 重新打开蓝图并确保它成功编译。 *** ### 5. 为上传准备资源 1. 找到文件夹：\ `Plugins/ Content/`\ （例如， `Plugins/AHK3LNKVC7FZA3I5JG3V Content/`) 2. 将整个 `Content/Metahumans/` 文件夹移动到此目录中。 * 使用 **Move Here** 完成该操作。 * 最终结构应与截图中显示的相同。
{% hint style="info" %} 此文件夹决定哪些内容会被打包并上传。确保所有内容都放置正确。 {% endhint %} *** ### 6. 打开 Asset Uploader 工具 * 导航到 `Content/Editor/AssetUploader`. * 右键单击 `AssetUploader` 并选择 **Run Editor Utility Widget**. *** ### 7. 选择角色资源 * 导航到 `Plugins/ Content/Metahumans//` 目录。 * 选择 `BP_` 蓝图。 * 然后，在 **Asset Uploader** 窗口中，点击 **Pick Asset**. *** ### 8. 捕获缩略图 * 在 Asset Uploader 窗口中，点击 **Capture Thumbnail** 为你的头像生成预览图。 *** ### 9. 在上传前验证功能 1. 拖拽 `BP_` 到关卡中。 2. 选择角色并定位 `BP_ConvaiChatbotComponent` 在 **Details** 面板中。 3. 输入一个测试 **Character ID**. 4. 按下 **Play** 并确认： * 动画正常工作 * 口型同步功能正常 * 角色表现符合预期 {% 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. 上传头像 * 在 Asset Uploader 中，点击 **Create Asset**. * 这将会： * 将头像打包为 Win64 * 将其上传到 Avatar Studio 监控 **Output Log**: * 查找 `Package completed` * 然后等待 `Uploaded Asset` {% hint style="warning" %} 如果打包过程中出现错误，请检查日志并将其分享到 [Convai Developer Forum](https://forum.convai.com/) 以获得支持。 {% endhint %} {% hint style="info" %} 要删除之前上传的资源，请打开 AssetUploader 并点击 **Delete**. {% 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 的组件上做不必要的工作。将同时运行的动画、物理、Control Rig 和程序化系统限制为当前交互所需的部分。 * **检查托管体验：** 上传后，请通过网站上的 Avatar Studio 使用该体验。检查加载和交互响应速度、动画流畅度、口型同步与音频时序，以及视觉一致性。 如果性能低于预期，请一次简化一个高成本功能并重新上传。先从毛发系统开始，然后是几何体、材质、纹理和自定义蓝图效果。 *** ## 访问头像 1. 前往 [Avatar Studio](https://convai.com/) 2. 打开 **Upload Your Custom Avatar** 部分 3. 你的 MetaHuman 将会出现，并可直接使用。 *** ## 总结 使用 Convai Asset Uploader，上传自定义 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, and the optional `goal` 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=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.