开发
开发
选择平台

设置头戴设备用于开发

更新时间: 2026年2月20日

视频:设置 Meta Quest 头戴设备用于开发所需的步骤。

本主题将介绍如何设置 Meta Quest 头戴设备以用于开发、调试和测试。
在本主题中,需要进行以下操作:
  • 将您的头戴设备与 Meta Horizon 移动应用配对
  • 安装 Android Debug Bridge
  • 安装 Meta Horizon Link
  • 安装 Meta Quest 开发者中心

前提条件

如要设置您的头戴设备用于开发和测试,您需要满足以下条件:

硬件要求

  • 开发机器运行以下操作系统之一:
    • Windows 10+(64 位)
    • macOS 10.10+(x86 或 ARM)
  • 支持的 Meta Quest 头戴设备:
    • Quest 2
    • Quest Pro
    • Quest 3
    • Quest 3S 和 3S Xbox 版
  • 使用以下方式之一连接头戴设备和开发机:
    • USB-C 数据线(推荐
    • Wi-Fi 连接,两台设备处于同一网络上

账户要求

将您的头戴设备与 Meta Horizon 移动应用配对

  1. 在移动设备上打开 Meta Horizon 应用。
    有关安装 Meta Horizon 移动应用的说明,请参阅在手机上安装 Meta Horizon 移动应用
  2. 使用您的 Meta 开发者账户登录信息登录该应用。
  3. 将头戴设备与应用配对。
  4. 戴上头戴设备,按照头戴设备中的说明完成设置。
有关特定 Quest 设备的详细说明,请参 入门设置指南。

启用开发者模式

在启用开发者模式之前,请确保满足以下前提条件:
  • 您已注册成为 Meta 开发者,拥有已认证的 Meta 账户。如要查看您的账户状态,请查看开发者面板中的验证版块。
  • 您已年满 18 岁。
  • 您的头戴设备没有任何阻止启用开发者模式的设备级限制。
按照以下步骤启用开发者模式:
  1. 在移动设备上打开 Meta Horizon 应用。
  2. 在应用中,轻触工具栏中的头戴设备图标。
    Meta Horizon toolbar
  3. 配对的头戴设备应显示在屏幕顶部。轻触头戴设备项目,显示配对头戴设备的型号和状态。
    Paired headset item
  4. 轻触头戴设备图片下方的头戴设备设置
    Headset settings
  5. 轻触开发者模式
    Developer mode list item
  6. 开发者模式切换到打开位置。
    Toggle Developer Mode to the on position
  7. 用一根 USB-C 数据线,将头戴设备连接到您的电脑。
    注意:如要在没有电脑的情况下进行设置,请在 Meta Quest 帮助中心查看特定设备的设置文档。
  8. 戴上头戴设备。
  9. 在头戴设备中,打开快速控制菜单项。
  10. 选择显示为齿轮图标的打开设置。然后,打开开发者选项卡,将 MTP 通知切换为开。
  11. 当系统提示是否允许 USB 调试时,选择始终对这台电脑允许
    Allow USB Debugging prompt
开发者模式适用于运行、调试和测试应用程序等开发任务。从事其他活动可能会导致账户受限、被暂停或终止。如需了解更多信息,请参阅内容准则
如要验证连接,请执行以下操作:
  1. 打开一个现有 Unity 项目。
    可使用您在设置 Unity 以用于 XR 开发中创建的那个项目。
  2. 前往 File(文件)> Build Profiles(构建个人主页)。
  3. Platforms(平台)下,选择 Meta Quest 并点击 Enable Platform(启用平台)。如果已安装配置文件,点击 Switch Platform(切换平台)。
    Unity versions prior to 6.1
    如果您的 Unity 版本中缺少 Meta Quest 平台,改为选择 Android 构建平台。
  4. Run Device(运行设备)列表中,选择该 Meta 头戴设备。如果您在列表中没有看到该 Meta 头戴设备,请选择刷新
  5. 选择构建并运行,指定名称和位置,以便输出 .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

Android Debug Bridge (ADB) 是一个命令行工具,支持在 XR 开发过程中执行很多有用的操作,包括:
  • 在头戴设备上安装应用
  • 在头戴设备上调试应用
  • 将文件复制到您的头戴设备
ADB 包含在 Unity 自带的 Android SDK 工具中,其路径位于 /Android/SDK/platform-tools/ 文件夹内。
如要启用 ADB,请执行以下操作:
  1. 确保您已通过 USB 连接设备
  2. 安装 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 驱动程序。
  3. 将安装目录添加到您的系统路径中。
    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
    
  4. 在开发机器上打开命令行,并运行以下命令,以检查连接的设备:
     adb devices
    
    您应该会看到与以下内容类似的输出结果:
     List of devices attached
     1PASH9BB939351	device
    

使用 ADB 安装应用

在验证设备已连接后,您可以使用 ADB 直接在头戴设备上安装 APK。
  1. 构建项目,生成 .apk 文件。
  2. 将 APK 安装到您的头戴设备上。
运行以下命令,在头戴设备上安装 APK:
adb install <APK_PATH>
例如,在 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 安装路径。云备份不会注册以这种方式安装的应用,也不会对其进行备份。
如需有关将 Meta Quest 设备与 ADB 结合使用(包括 Wi-Fi 连接、其他命令和疑难解决)的更多文档,请参阅适用于 Meta Quest 的 Android Debug Bridge
有关使用 ADB 的详情,请参阅官方 Android 文档中的 Android Debug Bridge
注意:目前只有 Windows 支持 Link。如果您在 macOS 上开发,或者没有头戴设备,请使用 Meta XR 模拟工具
若要使用 Link 预览您的场景,请遵循以下步骤操作:
  1. 下载 Link 并在机器上安装应用。
  2. 戴上头戴设备。
  3. 选择菜单栏左侧的时钟,打开快速设置窗口。
  4. 打开设置,选择 Quest Link,然后将 Quest Link 切换为打开状态。
  5. 选择启动 Quest Link,在开发机器和头戴设备上启动 Link。
  6. 在您的 Unity 项目中,按下播放 (►),在您的头戴设备上运行应用。
如需详细了解 Link,请参阅在应用开发阶段使用 Link

下载并安装 MQDH

Meta Quest 开发者中心 (MQDH) 是一个用于 Windows 和 MacOS 的应用程序,它允许开发者管理设备、调试应用并将应用提交到商店。
  1. 下载并安装用于 macOSWindows 的 Meta Quest 开发者中心应用程序。
  2. 打开应用程序并使用您的 Meta 开发者凭证登录。
  3. 在左侧导航窗格中,选择设备管理器。您设置的所有设备都显示在主窗格中。每台设备都显示其状态,其中包括设备 ID 和连接状态。活动设备显示绿色激活标识符。
有关 MQDH 的更多信息,请参阅 Meta Quest 开发者中心概览

详细了解

如需详细了解 Meta Quest 设备设置和连接,请参阅以下资源:

后续步骤

在您设置好用于开发的 Meta Quest 设备后,即可着手探索 Meta Quest 功能和功能模块