开发

XR 插件管理（适用于 Meta Quest）

更新时间: 2025年4月8日

如果您是使用 Unity 开发 Quest 体验的新手，请查看 Hello World 指南来创建您的第一个 VR 应用。

Unity 借助 Unity XR 插件管理系统⁠，支持在各种平台上进行 XR 开发。

以下提供方插件支持 Meta Quest 设备：

Unity OpenXR 插件⁠（推荐）

推荐版本：1.15.1

需要 Unity 6 或更高版本、Meta XR SDK v74 或更高版本。

Oculus XR 插件⁠（已停用）

推荐版本：4.5.1

需要 Unity 2022 或更高版本、Meta XR SDK v73 或更早版本。

Oculus XR Plugin is deprecated

Oculus XR 插件已停用并计划移除。请改用 Unity OpenXR 插件。

Unity OpenXR 插件

Unity OpenXR 插件⁠旨在统一各种 OpenXR 后端。

使用 Unity OpenXR 插件具有以下限制：

Unity 6 以下版本和 Meta XR 核心 SDK v74 以下版本均不支持 Depth API。

为了正常使用 Depth API 遮挡功能，必须使用 Unity OpenXR Meta 插件扩展 (com.unity.xr.meta-openxr@2.1.0) 及 Unity 6 或更高版本。详情请参阅 Unity OpenXR Meta：插件扩展。

对于版本低于 1.9⁠ 的 OpenXR，设置跟踪原点 STAGE 需要在更新世界原点之前重新居中。

安装 Unity OpenXR 插件

所有新项目都应安装 Unity OpenXR 插件，以获得最新功能与优化带来的优势。

如要安装 OpenXR 提供方插件，请执行以下操作：

在 Unity 编辑器 2022.3.15f1 或更高版本中打开任意一个 3D 项目（推荐使用 6.1 或更高版本）

在 Unity 编辑器的顶部菜单中，前往 Edit（编辑）> Project Settings（项目设置），打开 Project Settings（项目设置）窗口。

在 Project Settings（项目设置）窗口中，选择 XR Plug-in Management（XR 插件管理）。

如果未安装 XR 插件管理，则选择 Install XR Plugin Management（安装 XR 插件管理）。

在 Windows, Mac, Linux settings（Windows、Mac 和 Linux 设置）选项卡中，选择 OpenXR。

在 Android, Meta Quest settings（Android、Meta Quest 设置）选项卡中，选择 OpenXR。

关闭 Project Settings（项目设置）窗口。

在 Unity 编辑器的顶部菜单中，前往 Window（窗口）> Package Management（软件包管理）> Package Manager（软件包管理工具），打开 Unity Package Manager（Unity 包管理工具）窗口。

确保左侧导航菜单中的 In Project（在项目中）突出显示。在 Search in Project（在项目中搜索）下，展开 Packages（软件包）- Unity 下拉菜单。

在左侧菜单中的包列表中，确认 OpenXR Plugin（OpenXR 插件）旁边有一个勾选标记，这表明该软件包已安装。

如需进一步了解如何设置 OpenXR 插件，请参阅 Unity OpenXR 插件设置文档。

Unity OpenXR Meta 插件扩展

Unity OpenXR 插件本身不支持 Depth API 遮挡功能。如要将遮挡功能集成到基于 Unity OpenXR 插件构建的项目中，您必须使用 Unity OpenXR Meta 插件扩展 (com.unity.xr.meta-openxr@2.1.0)⁠。

如要安装插件扩展程序，请执行以下操作：

在 Unity 6 中打开 Package Manager（软件包管理工具）。

选择 Unity Registry（Unity 注册表）

搜索 Unity Open XR Meta 软件包

注意：此操作会将 ARFoundation 和 OpenXR 软件包作为依赖项安装到您的项目中。

Oculus XR 插件

Oculus XR Plugin is deprecated

Oculus XR 插件已停用并计划移除。请改用 Unity OpenXR 插件。

Unity 通过 Oculus XR 插件推动 Meta Quest 头戴设备的 XR 开发进程。Oculus XR 插件提供了如渲染模式、深度缓冲区共享以及延迟优化等常见的生命周期管理和运行时设置选项。

Meta XR 核心 SDK 集成了具备内置编辑器支持和若干附加功能的 OVRPlugin。OVRPlugin 和 Unity 的 Oculus XR 插件结合使用可使 Unity 能够与 Meta Quest 头戴设备上的 OpenXR、VRAPI 和 CAPI 后端进行互动。Meta 已将 OpenXR 运行时设为默认后端，旨在加快 OpenXR 的采用速度，同时让您能够运用相同的 API 无缝适配各种 Meta AR/VR 头戴设备。所有新功能仅在 OpenXR 后端可用。

Unity 的 Oculus XR 插件提供在 Meta Quest 头戴设备上运行 XR 应用程序的基础功能。当项目需要用到最新功能时，我们建议采用 Meta XR 核心 SDK 包。Meta XR 核心 SDK 包含最新版的 OVRPlugin，以及展示 Unity API 尚未提供的 Meta Quest 功能的实用 C# 脚本。例如，呈现平台、语音、手势追踪、互动等高级功能可借助 Meta XR 核心 SDK，而非通过 Unity API 实现。