Unity 项目设置

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

前提条件

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

安装 Unity 编辑器 版本 6000.0.23f1 和 Android 构建支持，其中包括

  • OpenJDK
  • Android SDK
  • Android NDK Tools

选择渲染引擎

我们建议使用 Vulkan Graphics API 来渲染 Android XR 应用。要将 Vulkan 选为您的 Graphics API，请按照以下步骤操作

  1. 在 Unity 中，前往 Edit > Project Settings > Player。
  2. 选择 Android 标签页，然后导航到 Other Settings > Rendering。
  3. 如果已启用 Auto Graphics API，请停用此设置以显示 Graphics APIs 部分。

  4. 在 Graphics APIs 部分中，选择 Add (+) 按钮，然后从下拉列表中选择 Vulkan。

    Example showing how to change the graphics api settings in the UI

  5. 使用句柄 (=) 重新排序 Graphics API，使 Vulkan 排在第一位。

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

通用渲染管线

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

下表列出了 Unity 推荐的 URP 设置，这些设置将在以下部分中更详细地说明。

设置

位置

推荐值

HDR

通用渲染管线资产

已停用

后期处理

通用渲染器数据

已停用

通用渲染管线资产设置

请按照以下步骤优化您的 Android XR 通用渲染管线资产

  1. 找到您项目的 通用渲染管线资产。一种方法是在 项目 窗口的搜索栏中输入 t:UniversalRenderPipelineAsset。

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

    Universal Render Pipeline Asset shown with recommended settings

通用渲染器数据设置

请按照以下步骤优化您的 Android XR 通用渲染器数据

  1. 找到您项目的 通用渲染器数据资产。一种方法是在 项目 窗口的搜索栏中输入 t:UniversalRendererData。

  2. 在 Inspector 中，在 后期处理 标题下，取消选中 已启用。

    Universal Renderer Data shown with recommended settings

最低 Android API 级别

将您的项目设置为最低 API 级别 24，这是 OpenXR Loader 所必需的。否则，您的构建可能会失败。

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

  1. 前往 Edit > Project Settings > Player。
  2. 选择 Android 标签页并打开 Other Settings。
  3. 在 Identification 部分中，对于 Minimal API level，选择 24 或更高。

应用入口点

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

  1. 前往 Edit > Project Settings > Player。
  2. 选择 Android 标签页并打开 Other Settings。
  3. 在 Configuration 部分中，确保 Application Entry Point 已选中 GameActivity 且未选中 Activity。

弹出窗口

大多数 Android XR 应用都需要可调整大小的窗口，因为它们需要渲染弹出窗口，例如系统权限请求。

按照以下步骤确保弹出窗口正确渲染。

  1. 前往 Edit > Project Settings > Player。
  2. 选择 Android 标签页并打开 Resolution and Presentation
  3. 在 Resolution 部分中，启用 Resizeable Activity。

另请参阅

OpenXR™ 和 OpenXR 徽标是 The Khronos Group Inc. 拥有的商标，并在中国、欧盟、日本和英国注册为商标。