> 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/convai-unity-sdk/compatibility-and-requirements/unity-versions-and-render-pipelines.md).

# Unity 版本和渲染管线

Convai Unity SDK 需要 Unity 2023.1.1f1 或更高版本。三种 Unity 渲染管线均受支持，无需额外配置。两种安装方式——包管理器和资源商店——都会自动安装所需的软件包依赖项。

### Unity 版本要求

| 要求      | 版本                                                                     |
| ------- | ---------------------------------------------------------------------- |
| 最低      | <code class="expression">space.vars.unity\_min\_version</code>         |
| 推荐用于新项目 | <code class="expression">space.vars.unity\_recommended\_version</code> |

{% hint style="warning" %}
Convai Unity SDK 不支持早于 2023.1.1f1 的 Unity 版本。如果你的项目使用的是较旧的 LTS 版本，请在安装前升级。
{% endhint %}

### 所需的软件包依赖项

该 SDK 依赖于三个 Unity 软件包。两种安装方式都会自动安装这些软件包——除非你遇到版本冲突，否则无需手动添加。

| 包                                 | 版本                                                                        |
| --------------------------------- | ------------------------------------------------------------------------- |
| `com.unity.nuget.newtonsoft-json` | <code class="expression">space.vars.dep\_newtonsoft\_json\_version</code> |
| `com.unity.ugui`                  | <code class="expression">space.vars.dep\_ugui\_version</code>             |
| `com.unity.inputsystem`           | <code class="expression">space.vars.dep\_inputsystem\_version</code>      |

{% hint style="warning" %}
安装后不要降级这些软件包。该 SDK 以上述版本为目标，低于这些版本时的行为未定义。如果你的项目已经在 `Packages/manifest.json`中固定了其中任何一个软件包的较旧版本，请在安装前移除或更新该固定设置。
{% endhint %}

### 渲染管线支持

SDK 运行时不包含任何特定于管线的条件判断。三种 Unity 渲染管线均完全受支持，无需额外配置。

| 渲染管线         | 支持     |
| ------------ | ------ |
| 内置渲染管线       | ✅ 完整支持 |
| 通用渲染管线（URP）  | ✅ 完整支持 |
| 高清渲染管线（HDRP） | ✅ 完整支持 |

{% hint style="info" %}
随附的示例场景使用 URP 材质。如果你的项目使用内置管线或 HDRP 管线，示例场景中的材质需要重新分配。可选的景深相机脚本位于 `SamplesShared/Camera/` 也同样是 URP 特定的，并非 SDK 功能所必需。
{% endhint %}

### 下一步

在确认你的 Unity 版本和软件包后，请检查你要面向哪些平台。

{% content-ref url="/pages/d9f64c1a3c295b98fd7638d4cc75e01943fa23bc" %}
[平台支持矩阵](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/compatibility-and-requirements/platform-support-matrix.md)
{% endcontent-ref %}


---

# 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/cha-jian-yu-ji-cheng/convai-unity-sdk/compatibility-and-requirements/unity-versions-and-render-pipelines.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.