HowTo

Unity 和 Android XR 使用入门

阅读用时:6 分钟
查看 Luke Hopkins 的个人资料
Luke Hopkins Android 开发者关系工程师

Samsung Galaxy XR 重磅登场,由 Android XR 提供支持!这篇博文是 Android XR Spotlight Week 系列内容的一部分。在该系列中,我们提供了博文、视频、示例代码等资源,旨在帮助您学习、构建和准备适用于 Android XR 的应用。

现在正是投身 XR 开发的大好时机。去年 12 月,我们发布了 Android XR,这是 Google 基于 OpenXR 和 Vulkan 等开放标准构建的全新 Android 平台,让 XR 开发变得前所未有地简单。


再结合 Unity 现有的 XR 工具,您将获得一个强大且成熟的开发技术栈。这样一来,您就可以创建和部署可在多种设备上运行的 XR 应用。

openxr_face_tracking2.webp

无论您之前是否进行过 XR 开发,我们都希望帮助您入门。

本博文将帮助您快速上手 Android XR 和 Unity 开发。我们将重点介绍配置环境、了解软件包生态系统和开始构建的实际步骤。

阅读完本博文后,您将充分了解:

  • 软件包生态系统
  • 基本设置步骤
  • 输入法
  • 隐私和权限
  • 合成层

Unity for Android XR 开发

您可能会选择 Unity,因为它具有跨平台兼容性,让您只需构建一次即可部署到 Android XR 和其他 XR 设备。

使用 Unity 时,您可以受益于其成熟的 XR 生态系统和工具。它已经拥有成熟的软件包,例如 XR Interaction Toolkit、OpenXR 插件、XR 组合层、XR Hands,以及一个包含大量 XR 就绪组件和模板的丰富资源商店,还有 XR 模拟和测试工具。此外,Unity 6 已于去年 11 月发布,您还可以受益于其改进的通用渲染管线 (URP) 性能、更出色的 Vulkan 图形支持以及增强的 build 配置文件。

以下是一些示例项目,可让您了解可以执行的操作:

基础设置:您的开发基础

Unity 6 要求和安装

您需要使用 Unity 6 来创建应用,因为更低版本不支持 Android XR。首先安装 Unity Hub,然后按照这些步骤安装 Unity 6 以及 Android Build Support 模块。

unity6.png

Android XR build 配置文件:简化配置

Unity build 配置文件是用于存储平台专属设置和配置的项目资源。因此,您无需在多个菜单中手动设置 15-20 个不同的设置,而是可以使用 build 配置文件自动完成此操作。
您可以创建自己的 build 配置文件,但目前我们建议您使用我们创建的专用 Android XR build 配置文件。

您可以在 Unity 项目中依次选择“文件”>“构建配置文件”,以选择构建配置文件。如需查看完整说明,请参阅针对 Android XR 进行开发工作流页面。

如果您自行进行了任何更改,则可以创建新的 build 性能分析报告,以便与团队分享。这样,您就可以确保在所有平台上获得一致的构建体验。

buildprofiles.png

完成这些步骤后,您就可以为 Android XR 设备构建和运行 APK 了。

图形 API:Vulkan 为何重要

使用 Android XR build 配置文件设置 Unity 项目后,我们首先建议您确保将 Vulkan 设置为图形 API。Android XR 是一个以 Vulkan 为先的平台。2025 年 3 月,Google 宣布 Vulkan 现已成为 Android 的官方图形 API。这是一种现代低级图形 API,可帮助开发者充分发挥现代 GPU 的性能,并解锁光线追踪和多线程等高级功能,从而打造逼真、沉浸式的游戏视觉效果。

这些标准可为您的现有应用提供最佳兼容性,并降低移植难度和成本。此外,它还支持启用高级 Android XR 功能,例如 URP 应用空间扭曲和注视点渲染。

Unity 6 会自动处理 Vulkan,因此当您使用 Android XR build 配置文件时,Unity 会将 Vulkan 配置为图形 API。这样可以确保您无需任何手动配置即可使用所有高级 Android XR 功能。

您可以依次前往“Edit”(编辑)>“Project Settings”(项目设置)>“Player”(可执行游戏文件)>“Android tab”(Android 标签页)>“Other settings”(其他设置)>“Graphics APIs”(图形 API),验证图形 API 设置。

graphics-api.png
appentrypoint.png

了解软件包生态系统

在 Unity 中,您可以使用两个不同的软件包来开发 Android XR 应用。一种是使用 Android XR Extensions for Unity,另一种是使用 Unity OpenXR: Android XR 软件包。

这些听起来可能是一回事,但请听我解释。

Unity OpenXR: Android XR 软件包是官方 Unity 软件包,用于支持 Android XR。它通过 OpenXR 标准提供大多数 Android XR 功能。它还支持 AR Foundation 集成,以实现混合现实功能。使用 Unity OpenXR: Android XR 软件包的主要好处是,它提供了一个统一的 API 来支持 XR 设备。


Android XR Extensions for Unity 是 Google 的 XR 软件包,专为 Android XR 设备开发而设计。它为 Unity OpenXR 软件包补充了其他功能,例如环境混合模式、场景网格、图片跟踪和身体跟踪。缺点是您只能开发 Android XR 设备应用。


具体选择哪种方式取决于您的具体需求,但我们通常建议您选择 Unity OpenXR: Android XR,因为这样可以大大提高应用兼容设备的灵活性,然后您可以根据应用要求添加 Android XR Extensions for Unity。

如何安装软件包

如需添加新软件包,请在 Unity 中打开项目,然后依次选择“Window”(窗口)>“Package Management”(软件包管理)>“Package Manager”(软件包管理器)。

在这里,您可以从“Unity Registry”标签页安装以下软件包:

packagemanager.png

您可以通过 GitHub 安装 Android XR for Unity 软件包,方法是选择 ➕ 图标,选择“Install package from git URL”(从 Git 网址安装软件包),然后输入“https://github.com/android/android-xr-unity-package.git”

packagemanager2.png

必需的 OpenXR 功能

现在,您已安装所需的软件包,接下来让我们启用一些核心功能,以便让项目正常运行。

您可以为 Android 启用 OpenXR 设置:“Edit”(修改)->“Project Settings”(项目设置)->“XR Plugin Management”(XR 插件管理)-> 点击 Android 并启用 OpenXR

xrpluginmgmt.png

接下来,我们需要启用对“Android XR support”的支持,我们将在需要时介绍其他 OpenXR 功能。目前,我们只需要启用 Android XR 支持。

输入

Android XR 支持手势、语音、眼动追踪、键盘和控制器输入。我们建议安装 XR Interaction Toolkit 和 XR Hands,因为它们包含最适合入门的预制件。通过使用这些预制件,您将拥有在应用中支持手势和控制器所需的一切。

xrinteractiontoolkit.png

安装 XR Hands 和 XR Interactive 工具包后,建议导入 Starter Assets 和 Hands Interaction Demo。然后,您需要启用 Hand Interaction 和 Khronos Simple Controller 配置文件,并开启手部追踪 Subsystem 和 Meta 手部追踪 Aim 功能。

您可以前往“Edit”(修改)>“Project Settings”(项目设置)>“XR Plug-in Management”(XR 插件管理)>“OpenXR”,修改这些设置

profiles.png

我们还建议使用 Unity 的预制件 XR Origin,它代表用户在 XR 空间中的位置和方向。其中包含从正确视角渲染 XR 体验所需的相机装置和跟踪组件。

添加此预制件的最简单方法是从我们之前导入的手部集成演示中导入,该演示位于“Hands Integration Toolkit”(手部集成工具包)>“Hand Interaction”(手部互动)>“Prefabs”(预制件)>“XR Origin”(XR 原点)

prefabs.png

我建议您在游戏对象中使用此预制件,而不是“XR Origin”选项,因为它使用 XR Input Modality Manager,可在用户的手和控制器之间自动切换。这样,您就能在手和控制器之间顺畅切换。

隐私和权限:建立用户信任

无论您构建什么,都需要从用户那里获取运行时权限。这是因为场景理解、眼动追踪、面部追踪和手部追踪功能会访问可能对用户而言更敏感的数据。

这些功能提供的个人信息比传统桌面或移动应用更深入,因此运行时权限可确保用户能够完全控制他们选择分享的数据。因此,为了遵守 Android 的安全和隐私权政策,Android XR 为每项功能都设置了权限。

例如,如果您使用 XR Hands 软件包来实现自定义手势,则需要请求手部追踪权限(见下文),因为该软件包需要追踪有关用户手部的大量信息。这包括跟踪手部关节姿势以及角速度和线速度等;

注意:如需查看需要权限的扩展程序的完整列表,请访问 XR 开发者网站。

const string k_Permission = "android.permission.HAND_TRACKING";

#if UNITY_ANDROID
void Start()
{
    if (!Permission.HasUserAuthorizedPermission(k_Permission))
    {
        var callbacks = new PermissionCallbacks();
        callbacks.PermissionDenied += OnPermissionDenied;
        callbacks.PermissionGranted += OnPermissionGranted;
        
        Permission.RequestUserPermission(k_Permission, callbacks);
    }
}

void OnPermissionDenied(string permission)
{
    // handle denied permission
}


void OnPermissionGranted(string permission)
{
    // handle granted permission
}

#endif // UNITY_ANDROID

使用合成层提升视觉质量

建议使用合成层来渲染界面元素。与 Unity 的标准渲染管线相比,它们能够以更高的质量显示元素,因为所有内容都会直接渲染到平台的合成器。

例如,如果您要显示文字,标准 Unity 渲染更有可能导致文字模糊、边缘柔和以及视觉伪影。而使用合成层时,文字会更清晰,轮廓会更分明,整体体验也会更好。


除了文字之外,它还能以更高的质量呈现视频、图片和界面元素。为此,它会利用对运行时合成器层的原生支持。

如需开启 Composition Layers,请打开 Package Manager,选择“Unity Register”,然后安装“XR Composition Layers”。

构建并运行

现在,您已安装 OpenXR 软件包并启用了相关功能,还设置了手部和头部运动的预制件,接下来就可以构建场景并直接部署到头戴设备进行测试了。

后续步骤:拓展您的技能

现在,您已设置好 Android XR 开发环境并了解了关键概念,接下来可以继续您的 XR 开发之旅:

持续学习的重要资源:

可供探索的示例项目:

作者:
继续阅读