> 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/asset-uploader.md).

# 资源上传器

{% hint style="danger" %}
资产上传器目前仅适用于专业版及以上套餐。
{% endhint %}

## 简介

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

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

{% embed url="<https://youtu.be/eFK9RFHDdco>" %}
Convai 资产上传器工具使用指南
{% endembed %}

***

## 先决条件

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

* **Unreal Engine 5.5**
* **Convai API 密钥** —你可以从 [Convai 仪表板](https://convai.com/)
* **.NET 6.0 运行时（控制台应用程序）** – [可在此处下载](https://dotnet.microsoft.com/en-us/download/dotnet/6.0/runtime?cid=getdotnetcore\&os=windows\&arch=x64)
* **Unreal Engine 5.5** [**跨编译工具链**](https://dev.epicgames.com/documentation/en-us/unreal-engine/linux-development-requirements-for-unreal-engine?application_version=5.5) **-** [可在此处下载](https://dev.epicgames.com/documentation/en-us/unreal-engine/linux-development-requirements-for-unreal-engine#version-history)
* **下载适用于 Unreal Engine 5.5 的 Linux 二进制文件 -** 你可以从 Epic Games 启动器下载

<figure><img src="/files/ccf8822fb1deaadcff627f51fda2086a3f7be325" alt=""><figcaption><p><strong>适用于 Unreal Engine 5.5 的 Linux 二进制文件</strong></p></figcaption></figure>

***

## 入门指南

### 步骤 1：下载资产上传器

下载最新版的 `AssetUploaderTool.exe` ，来自我们的 [GitHub Releases](https://github.com/Conv-AI/Convai-UnrealEngine-ModdingTool/releases).

{% hint style="info" %}
资产上传器工具将自动创建并配置你的 Convai Unreal 项目。
{% endhint %}

***

### 步骤 2：运行上传器工具

1. 将下载的 `AssetUploaderTool.exe` 文件移动到你希望创建新 Unreal 项目的目录。
2. 双击运行 `.exe`.
3. 如果你看到“Windows 已保护你的电脑”界面，点击 **更多信息** > **仍要运行**.

{% hint style="success" %}
别担心！这个可执行文件可以安全使用。之所以会显示该警告，是因为该工具目前处于测试阶段，且尚未进行数字签名。
{% endhint %}

***

### 步骤 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 插件**
* 开始编译项目

当你看到以下消息时：

```
Unreal 编译已成功完成
```

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

***

## 项目位置

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

> 例如：如果工具放在 `Downloads`相同的目录中，你的项目将生成在 `Downloads`.

***

## .NET 运行时错误

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

* 安装 **.NET 6.0 控制台应用运行时** 来自 [此链接](https://dotnet.microsoft.com/en-us/download/dotnet/6.0/runtime?cid=getdotnetcore\&os=windows\&arch=x64).

***

## 重要说明

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

***

## 后续步骤

继续查看以下指南之一：

* [上传 Metahuman 头像](/api-docs/zh/wu-dai-ma-ti-yan/avatar-studio-experiences/customizing-your-avatar/configure-avatar/uploading-avatars/metahuman-avatars.md)
* [上传 Reallusion 头像](/api-docs/zh/wu-dai-ma-ti-yan/avatar-studio-experiences/customizing-your-avatar/configure-avatar/uploading-avatars/reallusion-avatars.md)

{% hint style="info" %}
目前，仅支持上传 Metahuman 和 Reallusion 虚拟形象。
{% endhint %}

***

## 需要帮助？

如果你遇到任何问题或有疑问，请随时通过 [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:

```
GET https://docs.convai.com/api-docs/zh/asset-uploader.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.