For the complete documentation index, see llms.txt. This page is also available as Markdown.

资源上传器

轻松将 Metahumans、Reallusion 角色和场景从 Unreal Engine 上传到 Convai Sim 和 Avatar Studio。

简介

Convai 资源上传器 使开发者能够直接从 Unreal EngineAvatar Studio 是位于 Convai Sim完成。它通过命令行界面自动完成项目创建、插件集成和资源打包,使整个过程简单可靠。

无论你上传的是场景、Metahuman 还是自定义的 Reallusion 角色,这个工具都能确保你的资源以兼容且可直接用于 Convai 的格式进行打包和传输。

Convai 资产上传器工具使用指南

先决条件

在开始之前,请确保你已准备好以下内容:

  • Unreal Engine 5.5

  • Convai API 密钥 —你可以从 Convai 仪表板

  • .NET 6.0 运行时(控制台应用程序)可在此处下载

  • Unreal Engine 5.5 跨编译工具链 - 可在此处下载

  • 下载适用于 Unreal Engine 5.5 的 Linux 二进制文件 - 你可以从 Epic Games 启动器下载

适用于 Unreal Engine 5.5 的 Linux 二进制文件

入门指南

步骤 1:下载资产上传器

下载最新版的 AssetUploaderTool.exe ,来自我们的 GitHub Releases.

资产上传器工具将自动创建并配置你的 Convai Unreal 项目。


步骤 2:运行上传器工具

  1. 将下载的 AssetUploaderTool.exe 文件移动到你希望创建新 Unreal 项目的目录。

  2. 双击运行 .exe.

  3. 如果你看到“Windows 已保护你的电脑”界面,点击 更多信息 > 仍要运行.


步骤 3:按照提示操作

资产上传器将在终端窗口中打开。你将依次完成以下步骤:

  1. Unreal Engine 路径检测 你会看到类似如下的消息: 找到有效的 Unreal Engine 路径:C:/Program Files/Epic Games/UE_5.5

    • 如果正确,请按 Y 确认

    • 回车 N 以手动提供其他路径

  2. 项目配置

    • 输入项目名称 (这将成为你的新 Unreal 项目)

    • 输入你的 Convai API 密钥 ,来自你的 Convai 账户

  3. 选择资源类型

    • 1 用于上传 场景

    • 2 用于上传 头像

  4. 选择头像类型 如果你选择了头像:

    • 你将被询问: 你的头像是否使用 Metahuman?

      • Y 用于 Metahuman 设置

      • N 用于 Reallusion 设置


接下来会发生什么

配置完成后,工具将:

  • 生成一个新的 Unreal Engine 项目

  • 自动安装并配置所有必要的 Convai 插件

  • 开始编译项目

当你看到以下消息时:

你的设置就完成了。按 回车 退出。


项目位置

你的新项目将创建在与 .exe.

例如:如果工具放在 Downloads相同的目录中,你的项目将生成在 Downloads.


.NET 运行时错误

如果你遇到与 .NET 运行时相关的错误:

  • 安装 .NET 6.0 控制台应用运行时 来自 此链接.


重要说明

  • 不要 不是 删除或重命名 ConvaiEssentials 文件夹。

  • 不要 不是 不要在插件文件夹外更改全局项目设置。

  • 对其他 Unreal Engine 版本的支持正在开发中。


后续步骤

继续查看以下指南之一:

目前,仅支持上传 Metahuman 和 Reallusion 虚拟形象。


需要帮助?

如果你遇到任何问题或有疑问,请随时通过 Convai 开发者论坛.

最后更新于

这有帮助吗?