Unity 版本和渲染管线

Convai Unity SDK 环境要求参考，包括最低 Unity 版本、所需包依赖项和渲染管线支持。

Convai Unity SDK 需要 Unity 6000.0.80f1 or later。在更早的 Unity 版本中没有受支持的配置，而且该 SDK 可在 Unity 6000.5 现在 Unity 已将场景标识迁移到 64 位。Unity 的三种渲染管线都受支持，无需额外配置，而且两种安装方式——Package Manager 和 Asset Store——都会自动解析所需的包依赖。

Unity 版本要求

要求	版本
最低	6000.0.80f1 or later
推荐用于新项目	Unity 6 (6000.x)

最低版本是硬性下限。Convai 不支持低于 Unity 6000.0.80f1 or later的任何配置，包括更早的 LTS 版本。请在安装 SDK 之前升级项目。

所需的包依赖

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

包	版本
com.unity.ai.inference	2.2.1
com.unity.nuget.newtonsoft-json	3.2.2
com.unity.ugui	2.0.0
com.unity.inputsystem	1.19.0

安装后不要将这些包降级。该 SDK 以上述版本为目标，在更低版本上的行为未定义。如果你的项目已经在 Packages/manifest.json中固定了这些包中的某个较旧版本，请在安装前移除或更新该固定版本。

基于 NavMesh 的移动还需要一个该 SDK 不会安装的额外包。 ConvaiNavMeshLocomotion 驱动内置的 Unity NavMeshAgent，但 NavMesh 的制作—— 窗口 > AI > Navigation 以及 NavMeshSurface 组件——来自 com.unity.ai.navigation。如果你的项目为角色移动烘焙了 NavMesh，请安装 com.unity.ai.navigation 通过包管理器自行安装。

渲染管线支持

该 SDK 会在运行时检测当前活动的渲染管线并自动适配。例如，Vision 模块的摄像机捕获路径在未分配渲染管线资源时使用内置渲染挂钩，在 URP 和 HDRP 上则使用显式渲染路径。Unity 的三种渲染管线都完全支持，无需手动配置。

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

在任何管线中，支持都无需手动配置，但 Vision 模块的 CameraVisionFrameSource 捕获方式会因管线而异。在 Built-in 管线中，它使用命令缓冲区渲染挂钩，不需要额外的渲染通道。在 URP 和 HDRP 上，它会回退到显式的渲染兼容路径，并额外发出一次 Camera.Render() 调用，每捕获一帧一次。

随附的示例场景使用 URP 材质。如果你的项目使用 Built-in 或 HDRP 管线，示例场景材质需要重新指定。位于 SamplesShared/Camera/ 中的可选景深摄像机脚本支持 URP 和 HDRP；在 Built-in 管线中，它们会跳过景深并改为记录警告。这些脚本都不是 SDK 功能所必需的。

下一步

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

平台支持矩阵