开发
开发
选择平台

将 Link 用于应用开发

更新时间: 2024年7月5日
Link 将助您缩短迭代时间,对于您在 Unity 或 Unreal 中开发的应用,当您在编辑器中选择 Play(播放)按钮 (►) 时,该功能会直接在设备上启动应用。这样一来,在开发过程中,您无需每次测试应用时都要在电脑端构建应用,然后再部署到 Meta Quest 头戴设备上。
注意:目前只有 Windows 支持 Link。如果您在 macOS 上开发,或者没有头戴设备,请使用 Meta XR 模拟工具
本主题将:
  • 概述 Meta Horizon Link 开发者应用。
  • 提及用于 Link 设置和基本用途的相关资源。
  • 讨论通过 Link 测试应用时的实用设置和故障排除操作。
Link 与 Meta Quest 3、Meta Quest 2 和 Meta Quest Pro 头戴设备兼容。

前提条件

限制

  • 在 Meta Horizon 商店发布的应用无法使用开发和实验性的功能,即便在 Link 设置中启用这些功能也是如此。
    重要注意事项:为确保在商店中发布应用前,所有功能都能照常运行,您必须先在设备上验证应用。
  • 通过 Link 运行时,应用在视觉外观和性能特征方面可能与在 Meta Quest 头戴设备上运行时有所不同。
  • 在使用 Link 时,您的设备会表现得像一台 PC VR 头戴设备,直到明确关闭该工具为止。
若要使用 Link 预览您的场景,请遵循以下步骤操作:
  1. 下载 Link 并在机器上安装应用。
  2. 戴上头戴设备。
  3. 选择菜单栏左侧的时钟,打开快速设置窗口。
  4. 打开设置,选择系统 > Quest Link,然后切换 Quest Link 为打开状态。
  5. 选择启动 Quest Link,在开发机器和头戴设备上启动 Link。
  6. 在您的 Unity 项目中,按下 Play(播放)(►),在您的头戴设备上运行应用。

配置功能设置以便进行开发

启用 OpenXR Runtime

  1. 在 Meta Horizon Link 应用中,前往设置 > 常规
  2. OpenXR Runtime 旁,选择把 Meta Horizon Link 设为使用中。启用后,该选项会显示为灰色。

开启开发者 Runtime 功能

  1. 在 Meta Horizon Link 应用中,前往设置 > 开发者
  2. 确保已开启开发者 Runtime 功能
假设您想要测试使用透视、视线追踪以及自然面部表情追踪的应用。
  1. 在 Meta Horizon Link 应用中,前往设置 > 开发者
  2. 确保开启下列选项:
    • 通过 Meta Horizon Link 透视
    • 通过 Meta Horizon Link 进行视线追踪
    • 通过 Meta Horizon Link 追踪自然面部表情
    注意:开启开发者 Runtime 功能后,这些功能选项才会出现。
  3. 开启各项功能后,请查看对话框。如果您同意对话框的内容,请选择开启
  4. 如果您已打开 Unity 或 Unreal 项目,开启这些通过 Link 支持的功能后,请重启编辑器。

测试连接

使用 USB-C 数据线连接您的头戴设备,然后在 Meta Horizon Link 应用中执行以下操作:
  1. 选择设备,并确保您的头戴设备显示在其中。
  2. 选择已连接的设备,然后在右侧菜单中选择设备设置
  3. 选择 Link 数据线,然后选择继续
  4. 连接头戴设备页面中,选择继续
  5. 检查数据线的连接情况页面中,选择测试连接
  6. 完成测试后,确保您收到兼容的连接消息。
    如要使用彩色透视,USB 连接应至少提供 2 Gbps 的有效带宽。
    如果测试返回不兼容的连接消息或带宽较低,您可能需要尝试使用不同的 USB-C 数据线。使用 Meta Horizon Link 数据线可确保兼容性。

检查带宽

您随时可以使用 Meta Horizon Link 应用内置的 USB 测速工具来测量连接速度:
  1. 在 Meta Horizon Link 应用中,前往设备
  2. 选择已连接的设备。
  3. 依次选择 USB 测试测试连接
为确保头戴设备与 Link 的连接正常,请在头戴设备上执行以下步骤:
  1. 前往设置 > 系统
  2. Quest Link 旁,开启访问权限。
开发者可以通过两种模式使用 Link:
  • 点击 Play(播放)按钮 (►),在 Unity 编辑器中直接运行场景
  • 将项目当作电脑独立应用来运行
无论采用哪种模式,应用都会从头戴设备收集完整的追踪数据。
大多数情况下,通过 Link 在电脑端运行您的应用与在头戴设备上运行是相似的。通过 Link 在电脑端运行应用时(包括点击编辑器中的 Play(播放)按钮和当作独立式应用),您(用户)既能在头戴设备的视区内看到应用的 3D 画面,也能在电脑屏幕上看到应用的正常画面。
注意:请确保您已在编辑 > 项目设置 > XR 插件管理 > Windows、Linux 和 Mac 设置下启用插件提供方(如 OpenXR)

禁用接近感应传感器

通过 Meta Quest 开发者中心 (MQDH) 禁用接近感应传感器是标准开发工作流程的一部分。
  1. 将头戴设备连接到开发机器。
  2. 打开机器上的 MQDH。
  3. 从 MQDH 的左侧导航栏中选择设备管理工具
  4. 设备列表中选择您的头戴设备。
  5. 设备操作下找到接近感应传感器
  6. 选择下拉菜单,将接近感应传感器禁用两小时或以上。
如需收集 Link 日志,您可以使用 Unity 编辑器和 Oculus 应用。
  1. 在 Unity 编辑器中,前往 Window(窗口)> General(常规)> Console(控制台)。
  2. 当头戴设备出现在电脑上的 Link 之中时,选择 Play(播放)按钮。
  3. 点击控制台右上角的三点图标,然后选择 Open Editor Log(打开编辑器日志)。
  4. 在您的硬盘上找到 OculusLogGather.exe。该文件的位置取决于 Oculus 应用的安装位置。一般来说,该文件应该位于您的 C:\Program Files\Oculus\Support\oculus-diagnostics 文件夹中。
  5. 运行 OculusLogGather.exe

解决性能问题

如需了解更多 Link 故障排除方法,请参阅通过画质偏好设置解决性能问题
这个页面对你有帮助吗?