> 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 <code class="expression">space.vars.unity\_min\_version</code>。三种 Unity 渲染管线均受支持，无需额外配置。两种安装方式——Package Manager 和 Asset Store——都会自动安装所需的包依赖。

### 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 不支持早于 <code class="expression">space.vars.unity\_min\_version</code>的 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 会在运行时检测当前激活的渲染管线并自动适配——例如，Vision 模块的摄像头捕获路径会在内置渲染钩子和明确的 SRP 兼容路径之间切换。三种 Unity 渲染管线均完全受支持，无需手动配置。

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

{% hint style="info" %}
随附的示例场景使用 URP 材质。如果你的项目使用内置或 HDRP 管线，示例场景中的材质需要重新指定。位于 `SamplesShared/Camera/` 中的可选景深摄像头脚本支持 URP 和 HDRP；在内置管线下，它们会跳过景深处理并记录警告。这些脚本都不是 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, and the optional `goal` 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>&goal=<endgoal>
```

`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.