本页内容

Meta Quest 3 入门指南

简介

本主题提供了有关如何快速上手 Meta™ Quest 和 OpenXR 进行快速入门。将应用程序部署到 Meta Quest 有两种方式:一种是“低沉浸式”应用程序,即应用程序在头显的默认 VR 环境中以窗口形式运行;另一种是“高沉浸式”VR 应用程序,即应用程序接管整个 VR 环境的渲染。

注意:本指南 主要针对 Quest 3,但其中许多步骤也适用于其他使用 OpenXR 的基于 Android 的头显。

先决条件

开始之前,您需要安装 Qt 6.8 或更高版本以及Qt Quick 3D Xr 模块。Qt Quick 3D Xr 模块是QtQuick3D 的一部分,将随其一同安装。此外,您还需要安装并配置 Android NDK、SDK 和 JDK。有关设置Qt Creator 进行 Android 开发的更多信息,请参阅《Qt for Android 入门指南》。

配置 Quest

您需要在设备上启用开发者模式,才能将应用程序部署到 Meta Quest 上。请下载 Meta Quest 开发者中心,以便从设备流式传输视频、启用无线调试等。

部署低沉浸式应用程序

部署低沉浸式应用程序的步骤与开发和部署Qt for Android 时相同。您无需进行任何修改,即可通过此方式将 Qt 示例部署到 Quest 上。

使 XR 应用程序支持 Meta Quest 所需的项目更改

为 Quest 准备 XR 应用程序需要一些额外的步骤,因为 QML 中的应用程序入口点 `QtQuick3D ` 略有不同。在常规的QtQuick3D 应用程序中,通过 `View3D ` 类型查看 3D 场景,但在 XR 应用程序中,则是通过 `XrView ` 类型查看。此外,还有 APIs in Qt Quick 3D Xr 一些专门用于实现 XR 应用程序的功能,例如手部追踪、空间锚点和透视模式。

还需修改 AndroidManifest.xml 文件,以包含目标设备 OEM 指定的必要权限和功能。对于 Quest,具体如下:

<meta-data android:name="com.oculus.intent.category.VR" android:value="vr_only"/>
<uses-permission android:name="com.oculus.permission.HAND_TRACKING" />
<uses-feature android:name="oculus.software.hand-tracking" android:required="false" />

更多信息请参阅Meta 的清单文档。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.