设置头戴设备用于开发
更新时间: 2026年2月20日
视频:设置 Meta Quest 头戴设备用于开发所需的步骤。
在本主题中,需要进行以下操作:
- 将您的头戴设备与 Meta Horizon 移动应用配对
- 安装 Android Debug Bridge
- 安装 Meta Horizon Link
- 安装 Meta Quest 开发者中心
如要设置您的头戴设备用于开发和测试,您需要满足以下条件:
- 开发机器运行以下操作系统之一:
Windows 10+(64 位)
macOS 10.10+(x86 或 ARM)
- 使用以下方式之一连接头戴设备和开发机:
- USB-C 数据线(推荐)
- Wi-Fi 连接,两台设备处于同一网络上
在移动设备上打开 Meta Horizon 应用。
- 使用您的 Meta 开发者账户登录信息登录该应用。
- 将头戴设备与应用配对。
- 戴上头戴设备,按照头戴设备中的说明完成设置。
有关特定 Quest 设备的详细说明,请参
入门设置指南。
在启用开发者模式之前,请确保满足以下前提条件:
- 您已注册成为 Meta 开发者,拥有已认证的 Meta 账户。如要查看您的账户状态,请查看开发者面板中的验证版块。
- 您已年满 18 岁。
- 您的头戴设备没有任何阻止启用开发者模式的设备级限制。
按照以下步骤启用开发者模式:
在移动设备上打开 Meta Horizon 应用。
在应用中,轻触工具栏中的头戴设备图标。
配对的头戴设备应显示在屏幕顶部。轻触头戴设备项目,显示配对头戴设备的型号和状态。
轻触头戴设备图片下方的头戴设备设置。
轻触开发者模式。
将开发者模式切换到打开位置。
用一根 USB-C 数据线,将头戴设备连接到您的电脑。
戴上头戴设备。
在头戴设备中,打开快速控制菜单项。
选择显示为齿轮图标的打开设置。然后,打开开发者选项卡,将 MTP 通知切换为开。
当系统提示是否允许 USB 调试时,选择始终对这台电脑允许。
开发者模式适用于运行、调试和测试应用程序等开发任务。从事其他活动可能会导致账户受限、被暂停或终止。如需了解更多信息,请参阅内容准则。 如要验证连接,请执行以下操作:
打开一个现有 Unity 项目。
- 前往 File(文件)> Build Profiles(构建个人主页)。
在 Platforms(平台)下,选择 Meta Quest 并点击 Enable Platform(启用平台)。如果已安装配置文件,点击 Switch Platform(切换平台)。
Unity versions prior to 6.1
如果您的 Unity 版本中缺少 Meta Quest 平台,改为选择 Android 构建平台。 - 从 Run Device(运行设备)列表中,选择该 Meta 头戴设备。如果您在列表中没有看到该 Meta 头戴设备,请选择刷新。
- 选择构建并运行,指定名称和位置,以便输出
.apk(Android 可执行)文件,然后选择保存,以构建并在您的头戴设备上运行该应用。
如果该应用在头戴设备上成功运行,表示您已正确连接设备。
确认连上设备后,设置以下工具来协助连接、测试和调试设备:
Android Debug Bridge (ADB) 是一款集成于
Android SDK 的命令行工具。您可以使用 ADB 安装应用和从电脑发出其他有用的命令。
Link 是一种开发工具,支持将应用程序从开发机器投射到 Meta Quest 头戴设备中。通过 Link,您可以直接从 Unity 编辑器的 Scene(场景)视图在头戴设备上启动您的应用,而无需为 Android 平台构建和部署该应用,从而大大减少 XR 应用程序的开发时间。
注意:目前只有 Windows 支持 Link。如果您在 macOS 上开发,或者没有头戴设备,请使用
Meta XR 模拟工具。
Android Debug Bridge (ADB) 是一个命令行工具,支持在 XR 开发过程中执行很多有用的操作,包括:
- 在头戴设备上安装应用
- 在头戴设备上调试应用
- 将文件复制到您的头戴设备
ADB 包含在 Unity 自带的 Android SDK 工具中,其路径位于 /Android/SDK/platform-tools/ 文件夹内。
如要启用 ADB,请执行以下操作:
- 确保您已通过 USB 连接设备。
安装 Oculus USB 驱动程序。
Windows:下载
OEM USB 驱动程序,提取
oculus-adb-driver-2.0 ZIP 文件,前往
/oculus-go-adb-driver-2.0/usb_driver/ 文件夹,右键点击
android_winusb.inf 文件,然后选择
安装。
macOS:跳到第 3 步,因为您无需任何其他 USB 驱动程序。
将安装目录添加到您的系统路径中。
Windows:如果您使用与 Unity 一同安装的 Android SDK,安装路径应类似于以下路径:
C:\Program Files\Unity\Hub\Editor\<version>\Editor\Data\PlaybackEngines\AndroidPlayer\SDK\platform-tools
macOS:如果您使用与 Unity 一同安装的 Android SDK,安装路径应类似于以下路径:
/Applications/Unity/Hub/Editor/<version>/PlaybackEngines/AndroidPlayer/SDK/platform-tools
在开发机器上打开命令行,并运行以下命令,以检查连接的设备:
您应该会看到与以下内容类似的输出结果:
List of devices attached
1PASH9BB939351 device
在验证设备已连接后,您可以使用 ADB 直接在头戴设备上安装 APK。
- 构建项目,生成
.apk 文件。 - 将 APK 安装到您的头戴设备上。
运行以下命令,在头戴设备上安装 APK:
例如,在 Windows 上:
adb install C:\Dev\Android\MyProject\VrApp.apk
在 macOS 上:
adb install ~/Dev/Android/MyProject/VrApp.apk
使用 -r 选项来覆盖目标设备上已安装的同名 APK:
adb install -r <APK_PATH>
注意:使用 adb install 安装应用会绕过正常的 Quest 安装路径。云备份不会注册以这种方式安装的应用,也不会对其进行备份。
注意:目前只有 Windows 支持 Link。如果您在 macOS 上开发,或者没有头戴设备,请使用
Meta XR 模拟工具。
若要使用 Link 预览您的场景,请遵循以下步骤操作:
- 下载 Link 并在机器上安装应用。
- 戴上头戴设备。
- 选择菜单栏左侧的时钟,打开快速设置窗口。
- 打开设置,选择 Quest Link,然后将 Quest Link 切换为打开状态。
选择启动 Quest Link,在开发机器和头戴设备上启动 Link。
- 在您的 Unity 项目中,按下播放 (►),在您的头戴设备上运行应用。
Meta Quest 开发者中心 (MQDH) 是一个用于 Windows 和 MacOS 的应用程序,它允许开发者管理设备、调试应用并将应用提交到商店。
- 下载并安装用于 macOS 或 Windows 的 Meta Quest 开发者中心应用程序。
- 打开应用程序并使用您的 Meta 开发者凭证登录。
- 在左侧导航窗格中,选择设备管理器。您设置的所有设备都显示在主窗格中。每台设备都显示其状态,其中包括设备 ID 和连接状态。活动设备显示绿色激活标识符。
如需详细了解 Meta Quest 设备设置和连接,请参阅以下资源: