Unity 项目设置

本指南详细介绍了在针对 Android XR 开发 Unity 应用时推荐的编辑器版本、图形设置、URP 设置和 Android 项目设置。

前提条件

如需使用 Unity 进行开发，您需要下载并安装 Unity Hub。

安装 6000.0.23f1 版或更高版本的 Unity 编辑器和 Android Build Support，其中包括：

• OpenJDK
• Android SDK
• Android NDK 工具

选择渲染引擎

我们建议使用 Vulkan Graphics API 渲染 Android XR 应用。如需选择 Vulkan 作为图形 API，请按以下步骤操作：

1. 在 Unity 中，依次前往 Edit（编辑）> Project Settings（项目设置）> Player（玩家）。
2. 选择 Android 标签页，然后依次选择 Other Settings > Rendering。
3. 如果Auto Graphics API 处于启用状态，请停用此设置以显示 Graphics API 部分。

4. 在 Graphics APIs（图形 API）部分，选择 Add (+)（添加）按钮，然后从下拉菜单中选择 Vulkan。

   

5. 使用句柄 (=) 重新排列图形 API，使 Vulkan 列在前面。

6. （可选）选择任何其他图形 API，然后点击移除 (-) 按钮将其移除。

通用渲染管线

Android XR 与通用渲染管线 (URP) 兼容。如果您打算使用透传功能，则应更新默认的 URP 设置，以便在 Android XR 上获得最佳透传性能。

注意： 对于包含为内置渲染管道制作的资源的现有项目，您应使用渲染管道转换器将这些资源转换为与 URP 兼容的资源。

下表列出了 Unity 建议的 URP 设置，以下部分将对其进行更详细的说明。

设置	位置信息	推荐值
HDR	通用渲染管线资产	已停用
后期处理	通用渲染程序数据	已停用

注意 ：如果您使用的是 URP，则必须使用 Vulkan。我们建议将 Vulkan 用作 Android XR 的图形 API，因为只有该 API 支持较新的图形功能。

通用渲染管线资产设置

请按照以下步骤优化适用于 Android XR 的通用渲染管道资源：

1. 找到项目的通用渲染管线资源。为此，您可以将 t:UniversalRenderPipelineAsset 输入到 Project 窗口的搜索栏中。

   注意： 如果您的项目不包含通用渲染管线资产，请参阅 URP 文档中的将通用渲染管线安装到现有项目中。

2. 在画质标题下，停用 HDR。

   

通用渲染程序数据设置

请按照以下步骤优化适用于 Android XR 的通用渲染程序数据：

1. 找到项目的通用渲染程序数据资产。为此，您可以将 t:UniversalRendererData 输入到 Project 窗口的搜索栏中。

2. 在 Inspector 的 Post-processing 标题下，取消选中 Enabled。

   

最低 Android API 级别

将项目的最低 API 级别设为 24，这是 OpenXR 加载器的要求。否则，您的 build 可能会失败。

请完成以下步骤以设置最低 Android API 级别。

1. 依次前往 Edit > Project Settings > Player。
2. 选择“Android”标签页，然后打开其他设置。
3. 在标识部分中，针对最低 API 级别，选择 24 或更高级别。

应用入口点

为应用入口点配置以下设置：

1. 依次前往 Edit > Project Settings > Player。
2. 选择 Android 标签页，然后打开其他设置。
3. 在 Application Entry Point 部分，确保选中 GameActivity 且未选中 Activity。

弹出式窗口

大多数 Android XR 应用都需要可调整大小的窗口，因为它们需要呈现系统权限请求等弹出式窗口。

请按照以下步骤操作，确保弹出式窗口正常呈现。

1. 依次前往 Edit > Project Settings > Player。
2. 选择 Android 标签页，然后启用可调整大小的 activity。

另请参阅

• Unity Android XR：OpenXR
• 为 Unity 导入 Android XR 扩展