支持的头显

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

XR 平台基础概念

QtQuick3D.Xr 支持两大主要平台：以 OpenXR 作为应用程序开发 API 的设备，以及采用苹果 visionOS 的设备。

OpenXR

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

某些 VR/AR 设备本身就是一套完整的应用程序部署和运行时平台。例如，Meta Quest 3就是一款基于 Android 系统的完整、独立设备。从应用程序开发者的角度来看，其开发流程与为 Android 智能手机和平板电脑开发应用程序非常相似。此类设备及其软件平台有时被称为“Standalone VR ”。

其他头显可能不提供完整的应用程序部署和运行时平台，而是与计算机配合使用，通常运行Windows或Linux系统，应用程序渲染的内容通过有线或无线连接流式传输至头显。 这种配置有时被称为“PCVR ”。在此情况下，应用程序的开发和部署方式与常规的 Windows 或 Linux 桌面应用程序相同。不过，它们不会像典型的桌面应用程序那样在屏幕上打开窗口并显示内容，而是通过 OpenXR 以及 Direct 3D 或 Vulkan 等 3D API 将内容渲染到屏幕外的缓冲区中。 生成的内容会被流式传输至头显进行显示；实际的流式传输及相关处理由底层软件栈管理，对 Qt 和应用程序而言是透明的。此类头显的例子包括 Varjo 公司的部分设备，以及 HTC Vive 系列中的非独立设备。

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

对于独立设备，所有渲染和处理都在头显本身上进行。OpenXR 及其底层运行时环境仅有一种实现，应用程序在设备上启动时会使用该实现。

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

非基于 OpenXR 的设备和平台

Qt Quick 3D Xr 目前支持一个非 OpenXR 平台：苹果的 visionOS。诸如Apple Vision Pro之类的设备属于“Standalone VR ”类别。

经过测试和验证的头显，一级

以下是 Qt 定期进行测试和验证，且在Qt Quick 3D XR 开发过程中被积极使用的设备列表。

• Meta Quest 3，独立模式（Android）
• Meta Quest 3，PCVR模式（Windows）
• Apple Vision Pro，独立模式（visionOS）

经过测试和验证的头显，第二级

以下是Qt Quick 3D XR开发过程中不定期进行测试的其他设备列表，这些设备预计可以正常工作，但无法保证其全部功能。

• Meta Quest 2，独立模式（Android）
• HTC Vive（PCVR模式，Linux）

特殊开发环境

以下是Qt Quick 3D XR开发过程中使用的VR模拟器解决方案列表，这些方案对应用程序开发者同样有所帮助。无法保证这些解决方案能提供全部功能，特别是在增强现实（AR）功能方面。

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

补充说明

如上所述，其他采用 OpenXR 的设备（例如 Pico 4）可能也能正常运行，但 Qt 尚未对此进行验证。在未来的 Qt 版本中，经过测试的设备列表预计会发生变化并不断增加。

对于 PCVR，还有其他需要考虑的软件堆栈细节和复杂情况。详情请参阅专门的PCVR页面。

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