支持的耳机

本页概述了QtQuick3D.Xr 测试和支持的平台和设备。

基本 XR 平台概念

QtQuick3D.Xr 支持两个主要平台：使用 OpenXR 作为应用程序开发 API 的设备和使用 Apple 的 visionOS 的设备。

OpenXR

OpenXR是一项开放标准，为开发 XR 应用程序提供了一套通用的 API。OpenXR 的实现适用于各种平台，如 Android 或 Windows。

有些 VR/AR 设备本身就是一个完整的应用部署和运行平台。例如，Meta Quest 3就是一个完整、独立的基于 Android 的设备。从应用程序开发人员的角度来看，其工作流程与为安卓手机和平板电脑开发非常相似。这类设备及其软件平台有时被称为Standalone VR 。

其他耳麦可能不提供完整的应用部署和运行平台，而是与电脑（通常运行 Windows 或 Linux）结合使用，通过有线或无线连接将应用渲染的内容从电脑流式传输到耳麦。这种设置有时被称为PCVR 。在这种情况下，应用程序是作为普通桌面 Windows 或 Linux 应用程序开发和部署的。不过，它们并不像典型的桌面应用程序那样在屏幕上打开窗口并显示内容，而是通过 OpenXR 和 3D API（如 Direct 3D 或 Vulkan）渲染到屏幕外的缓冲区。由此产生的内容将流式传输到耳机显示；实际的流式传输和相关处理由底层软件栈管理，对 Qt Application Manager 和应用程序透明。Varjo 的一些设备或 HTC Vive 系列中的非独立设备就是此类头显的一个例子。

有些设备同时属于这两类。最值得注意的是，Meta Quest 3 支持两种操作模式。

对于独立设备，所有的渲染和处理都在头显本身进行。OpenXR 和底层运行环境只有一个实施方案，应用程序在设备上启动时将使用该实施方案。

对于非独立设备，所有渲染和大部分相关处理都在主机上进行。质量和性能在很大程度上取决于主机 PC 的能力，但流媒体技术和相关因素（如无线网络带宽）也会影响效果。在 PCVR 领域，有多种解决方案可提供 OpenXR 实现以及有线或无线流媒体。

不基于 OpenXR 的设备和平台

Qt Quick 3D Xr 目前支持一个非 OpenXR 平台：Apple 的 visionOS。Apple Vision Pro等设备属于 类别。Standalone VR

经过测试和验证的耳机，一级

这是 Qt Test 定期测试和验证并在Qt Quick 3D Xr 开发过程中积极使用的设备列表。

• Meta Quest 3，独立（安卓）
• Meta Quest 3，PCVR 模式（Windows）
• Apple Vision Pro，单机版（visionOS）

经过测试和验证的耳机，二级

这是一份附加设备列表，在Qt Quick 3D Xr 开发过程中偶尔会对这些设备进行测试，预计它们可以正常工作，但无法保证其全部功能。

• Meta Quest 2，单机版（安卓）
• PCVR 模式下的 HTC Vive（Linux）

特殊开发者环境

这是Qt Quick 3D Xr 开发过程中使用的 VR 模拟器解决方案列表，对应用程序开发人员也很有用。这些解决方案不能保证实现全部功能，尤其是在涉及 AR 功能时。

• Meta XR 模拟器（Windows）。这是一款适用于 Windows 的 OpenXR 实现，可在桌面窗口中分别显示左眼和右眼的渲染内容，同时提供输入控制器模拟和许多其他面向开发人员的功能。从应用程序的角度来看，使用该模拟器与在 Windows 上使用 PCVR 并无不同。

附加说明

如上所述，使用 OpenXR 的其他设备（如 Pico 4）可能也能正常工作，但 Qt 并未对此进行验证。在未来的 Qt Test 版本中，经过测试的设备列表会有所变化和增加。

说到 PCVR，可能需要考虑更多的软件栈细节和复杂性。详情请查看PCVR专页。

Qt Quick 3D Xr 默认在调试输出中打印警告。诊断信息不会打印出来。要启用这些信息，请启用 日志类别。例如，通过设置环境变量 。更多信息请参见 。强烈建议在出现问题或应用程序未按预期启动时启用附加调试打印。报告问题时，一定要在错误报告中包含完整日志。由于运行 XR 应用程序的方式多种多样，尤其是涉及 OpenXR 时，这些日志对于更好地了解发生了什么至关重要。qt.quick3d.xr QT_LOGGING_RULES=qt.quick3d.xr=true QLoggingCategory