资源上传器

使用 Convai 资源上传器工具，将 Metahuman、Reallusion 角色以及场景从 Unreal Engine 上传到 Convai Sim 和 Avatar Studio。

Convai 资源上传器可将 Unreal Engine 中的 MetaHuman、Reallusion 角色和场景直接上传到 Avatar Studio 和 Convai Sim。该工具通过命令行界面自动完成项目创建、插件集成和资源打包。请使用此页面安装该工具，并将其运行于一个 Unreal Engine 5.8 项目中，然后上传你的第一个资源。

资源上传器仅适用于专业版套餐及以上。

Convai 资源上传器工具操作指南

---

先决条件

在运行资源上传器之前，请确认以下内容：

• Unreal Engine 5.8
• 来自以下位置的 Convai API 密钥： Convai 仪表板
• .NET 6.0 运行时（控制台应用程序）— 下载 .NET 6.0 控制台运行时
• Unreal Engine 5.8 交叉编译工具链要求，包括 工具链版本历史
• Unreal Engine 的 Linux 二进制文件 5.8，可通过 Epic Games 启动器获取

---

下载并运行该工具

1

下载资源上传器

下载最新的 AssetUploaderTool.exe ，来自 Convai 资源上传器 GitHub 发行版。将该文件移动到你希望创建新 Unreal Engine 项目的目录中——该工具会自动创建并配置 Convai Unreal Engine 项目。

2

运行上传器工具

双击 AssetUploaderTool.exe 以运行它。如果 Windows 显示“Windows 已保护你的电脑”界面，请选择 更多信息 > 仍然运行。该工具可以安全运行——之所以出现此警告，是因为该工具目前处于 Beta 版且未进行数字签名。

3

按提示操作

该工具会在终端窗口中打开，并引导完成：

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 设置。

---

验证上传

配置完成后，该工具会生成一个新的 Unreal Engine 项目，安装并配置 Convai 插件，然后开始编译项目。终端显示以下内容时，上传即完成：

Unreal 编译已成功完成

按 Enter 退出。

新项目会创建在与 AssetUploaderTool.exe相同的目录中。例如，如果该工具放在 Downloads中，则项目会生成在 Downloads.

---

故障排除

运行工具时出现 .NET 运行时错误

症状： 该工具报告缺少 .NET 运行时错误。

原因： .NET 6.0 控制台应用程序运行时未安装。

解决方法： 安装 适用于控制台应用的 .NET 6.0 运行时.

验证： 重新运行 AssetUploaderTool.exe — 工具启动时不再出现运行时错误。

---

项目和插件限制

• 请勿删除或重命名 ConvaiEssentials 文件夹。
• 不要更改插件文件夹之外的全局项目设置。
• 对其他 Unreal Engine 版本的支持正在开发中。

---

下一步

目前仅支持上传 MetaHuman 和 Reallusion 头像。

MetaHuman 头像Reallusion 头像

---

需要帮助？

如果你遇到问题或有疑问，请通过以下渠道联系 Convai 开发者论坛.