SuperAPI AI 工具集

hz-xr-simulator-install-and-configure

测试与质量

查看项目

更新于 10-16 09:32

技能介绍

用途:在没有实体头显时测试 Meta VR 与 Horizon OS 应用,便于开发期快速迭代,并为需要自动化测试的 CI/CD 流程提供支持;可在部署到硬件前验证核心交互、UI 与移动方式。

主要能力:作为桌面工具模拟 Meta VR 环境,拦截应用的 OpenXR 运行时调用,提供模拟的头显追踪、手柄输入、手部追踪与环境数据。支持模拟头显位姿、手柄按键/摇杆/扳机、预定义手势、房间与守护边界、合成透视画面,以及可脚本化的测试场景、录制回放与 CI/CD 回归测试。支持 Windows 10/11(64 位,完整支持)与 macOS(有限支持)。支持 Unity(Meta XR SDK)、Unreal(Meta XR Plugin)及以本模拟器为活动 OpenXR 运行时的原生 OpenXR 应用。

使用方式:从 Meta Quest Developer Hub 的 Tools、Meta 开发者下载页获取,或用 CLI 执行 metavr tools install xrsim。在 Windows 运行安装程序,macOS 解压归档。随后在引擎中启用:Unity 在 Edit > Project Settings > XR Plug-in Management 启用 Meta XR Simulator 为活动运行时;Unreal 在 Project Settings > Plugins > Meta XR 启用 XR Simulator;原生 OpenXR 则将其设为活动 OpenXR 运行时后启动桌面构建。在编辑器按 Play 即可运行。控制方面:按住鼠标右键移动视角,W/S/A/D 前后左右,E/Q 上下,手柄与手势通过映射按键触发。安装集成后可用 hz-xr-simulator-control 启动、查看运行时状态、修改设置、管理图层和录制合成输出。

限制:模拟器不还原硬件性能,仅用于功能测试而非性能剖析。桌面 GPU 与驱动不同于 Quest 的 Adreno GPU,着色器表现可能不同;无真实传感器数据,IMU、相机与深度数据为合成;部分平台 API 返回模拟或桩数据;无触觉反馈;无热降频模拟;分辨率、注视点渲染与刷新率与硬件不一致。手部追踪为离散预定义姿态而非连续追踪。透视为合成而非基于相机,反射、透明、低光等边界情形无法复现。macOS 功能不完整,手部追踪、透视与房间设置支持不足,建议用 Windows。还需注意:其他 OpenXR 运行时可能抢占,需将本模拟器设为活动运行时(Windows 可查 HKEY_LOCAL_MACHINE\SOFTWARE\Khronos\OpenXR\1\ActiveRuntime);Unity 中启用模拟器不会自动禁用 Oculus 或 OpenXR 加载器,需先禁用其他加载器;部分企业杀毒软件可能阻断本地 IPC,出现连接后立即断开或无法启动 XR 会话时检查防火墙规则。提交或发布前务必在实体 Meta VR 硬件上做最终验证。具体系统要求、配置项与完整测试流程的资料暂未提供。