> 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/cha-jian-yu-ji-cheng/asset-uploader.md).
# 资源上传器
Convai 资源上传器可将 Unreal Engine 中的 MetaHuman、Reallusion 角色和场景直接上传到 Avatar Studio 和 Convai Sim。该工具通过命令行界面自动完成项目创建、插件集成和资源打包。请使用此页面安装该工具，并将其运行于一个 Unreal Engine space.vars.asset\_uploader\_unreal\_version 项目中，然后上传你的第一个资源。
{% hint style="danger" %}
资源上传器仅适用于专业版套餐及以上。
{% endhint %}
{% embed url="" %}
Convai 资源上传器工具操作指南
{% endembed %}
***
### 先决条件
在运行资源上传器之前，请确认以下内容：
* Unreal Engine space.vars.asset\_uploader\_unreal\_version
* 来自以下位置的 Convai API 密钥： [Convai 仪表板](https://convai.com/)
* .NET 6.0 运行时（控制台应用程序）— [下载 .NET 6.0 控制台运行时](https://dotnet.microsoft.com/en-us/download/dotnet/6.0/runtime?cid=getdotnetcore\&os=windows\&arch=x64)
* Unreal Engine space.vars.asset\_uploader\_unreal\_version [交叉编译工具链要求](https://dev.epicgames.com/documentation/en-us/unreal-engine/linux-development-requirements-for-unreal-engine?application_version=5.8)，包括 [工具链版本历史](https://dev.epicgames.com/documentation/en-us/unreal-engine/linux-development-requirements-for-unreal-engine#version-history)
* Unreal Engine 的 Linux 二进制文件 space.vars.asset\_uploader\_unreal\_version，可通过 Epic Games 启动器获取
***
### 下载并运行该工具
{% stepper %}
{% step %}
#### 下载资源上传器
下载最新的 `AssetUploaderTool.exe` ，来自 [Convai 资源上传器 GitHub 发行版](https://github.com/Conv-AI/Convai-UnrealEngine-ModdingTool/releases)。将该文件移动到你希望创建新 Unreal Engine 项目的目录中——该工具会自动创建并配置 Convai Unreal Engine 项目。
{% endstep %}
{% step %}
#### 运行上传器工具
双击 `AssetUploaderTool.exe` 以运行它。如果 Windows 显示“Windows 已保护你的电脑”界面，请选择 **更多信息 > 仍然运行**。该工具可以安全运行——之所以出现此警告，是因为该工具目前处于 Beta 版且未进行数字签名。
{% endstep %}
{% step %}
#### 按提示操作
该工具会在终端窗口中打开，并引导完成：
1. **Unreal Engine 路径检测** — 请确认类似以下的消息： `找到有效的 Unreal Engine 路径：C:/Program Files/Epic Games/UE_5.8`。输入 `Y` 以确认该路径，或输入 `N` 以提供其他路径。
2. **项目配置** — 输入项目名称和你的 Convai API 密钥。
3. **资源类型选择** — 按 `1` 以上传场景，或 `2` 以上传头像。
4. **头像类型选择** （仅限头像）— 对以下问题作出回答： `你正在为你的头像使用 MetaHuman 吗？` 输入 `Y` 用于 MetaHuman 设置，或输入 `N` 用于 Reallusion 设置。
{% endstep %}
{% endstepper %}
***
### 验证上传
配置完成后，该工具会生成一个新的 Unreal Engine 项目，安装并配置 Convai 插件，然后开始编译项目。终端显示以下内容时，上传即完成：
```
Unreal 编译已成功完成
```
按 `Enter` 退出。
新项目会创建在与 `AssetUploaderTool.exe`相同的目录中。例如，如果该工具放在 `Downloads`中，则项目会生成在 `Downloads`.
***
### 故障排除
#### 运行工具时出现 .NET 运行时错误
**症状：** 该工具报告缺少 .NET 运行时错误。
**原因：** .NET 6.0 控制台应用程序运行时未安装。
**解决方法：** 安装 [适用于控制台应用的 .NET 6.0 运行时](https://dotnet.microsoft.com/en-us/download/dotnet/6.0/runtime?cid=getdotnetcore\&os=windows\&arch=x64).
**验证：** 重新运行 `AssetUploaderTool.exe` — 工具启动时不再出现运行时错误。
***
### 项目和插件限制
* 请勿删除或重命名 `ConvaiEssentials` 文件夹。
* 不要更改插件文件夹之外的全局项目设置。
* 对其他 Unreal Engine 版本的支持正在开发中。
***
### 下一步
目前仅支持上传 MetaHuman 和 Reallusion 头像。
{% content-ref url="/pages/69cb60fe0b9585cb40eca5a1c91e3a0e96d346ef" %}
[Metahuman 头像](/api-docs/zh/wu-dai-ma-ti-yan/avatar-studio-experiences/customizing-your-avatar/configure-avatar/uploading-avatars/metahuman-avatars.md)
{% endcontent-ref %}
{% content-ref url="/pages/3069faf39cce4edbd0215d51e68dfd2c35d9b04c" %}
[Reallusion 头像](/api-docs/zh/wu-dai-ma-ti-yan/avatar-studio-experiences/customizing-your-avatar/configure-avatar/uploading-avatars/reallusion-avatars.md)
{% endcontent-ref %}
***
### 需要帮助？
如果你遇到问题或有疑问，请通过以下渠道联系 [Convai 开发者论坛](https://forum.convai.com/).
---
# 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/cha-jian-yu-ji-cheng/asset-uploader.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.