本指南详细介绍了为 Android XR 开发 Unity 应用时推荐的编辑器版本、图形设置、URP 设置和 Android 项目设置。
前提条件
如需使用 Unity 进行开发，您需要下载并安装 Unity Hub。
安装 Unity Editor 和 Android Build Support 的 6000.0.58f2 或更高版本，其中包括：
- OpenJDK
- Android SDK
- Android NDK 工具
选择渲染引擎
我们建议使用 Vulkan Graphics API 渲染 Android XR 应用。如需选择 Vulkan 作为 Graphics API，请按以下步骤操作：
- 在 Unity 中，依次前往 Edit > Project Settings > Player 。
- 选择 Android 标签页，然后依次前往 Other Settings > Rendering 。
- 如果 Auto Graphics API 处于启用状态，请停用此设置以显示 Graphics APIs 部分。
在 Graphics APIs 部分中，选择 Add (+) 按钮，然后从下拉列表中选择 Vulkan 。
使用句柄 (=) 重新排序 Graphics API，使 Vulkan 列在最前面。
（可选）选择任何其他 Graphics API，然后点击 Remove (-) 按钮将其移除。
通用渲染管线
Android XR 与通用渲染管线 (URP) 兼容。如果您打算使用透视功能，则应更新默认 URP 设置，以便在 Android XR 上获得最佳透视性能。
下表列出了 Unity 推荐的 URP 设置，以下部分将对此进行更详细的说明。
设置 |
位置 |
推荐值 |
|---|---|---|
HDR |
通用渲染管线资源 |
已停用 |
后期处理 |
通用渲染器数据 |
已停用 |
通用渲染管线资源设置
请按照以下步骤优化 Android XR 的通用渲染管线资源：
找到项目的通用渲染管线资源 。一种方法是在项目 窗口的搜索栏中输入
t:UniversalRenderPipelineAsset。在质量 标题下，停用 HDR 。
通用渲染器数据设置
请按照以下步骤优化 Android XR 的通用渲染器数据：
找到项目的通用渲染器数据资源 。一种方法是在项目 窗口的搜索栏中输入
t:UniversalRendererData。在 Inspector 中，在 后期处理 标题下，取消选中 已启用 。
最低 Android API 级别
将项目的最低 API 级别设置为 24，这是 OpenXR 加载器所要求的级别。否则，您的 build 可能会失败。
请完成以下步骤来设置最低 Android API 级别。
- 依次前往 Edit > Project Settings > Player 。
- 选择 Android 标签页，然后打开 Other Settings 。
- 在 Identification 部分中，对于 Minimal API level，选择 24 或 更高版本。
应用入口点
为应用入口点配置以下设置：
- 依次前往 Edit > Project Settings > Player 。
- 选择 Android 标签页，然后打开 Other Settings 。
- 在 Configuration 部分中，确保 Application Entry Point 已选中 GameActivity ，且未选中 Activity 。
对话框
大多数 Android XR 应用都需要可调整大小的窗口，因为它们需要渲染对话框，例如系统权限请求。
请按照以下步骤确保对话框正确渲染。
- 依次前往 Edit > Project Settings > Player 。
- 选择 Android 标签页，然后打开 Resolution and Presentation
- 在 Resolution 部分中，启用 Resizeable Activity 。
另请参阅
OpenXR™ 和 OpenXR 徽标是 The Khronos Group Inc. 的商标，并且已在中国、欧盟、日本和英国注册为商标。