SuperAPI AI 工具集

hz-xr-simulator-setup

测试与质量

查看项目

更新于 10-16 06:47

技能介绍

用途:在未连接实体头显时测试 Quest VR/MR 应用,支持开发期快速迭代、CI/CD 自动化测试,以及在部署到硬件前验证交互、UI 与移动方式。

主要能力:模拟头显追踪(鼠标键盘控制位置与旋转)、模拟手柄输入(键盘映射 Touch 按键、摇杆、扳机)、模拟手部追踪(预设手势序列)、房间与守护边界模拟、合成透视画面用于 MR 测试,以及可脚本化的测试场景与录制回放。

使用方式:从 Meta Quest Developer Hub(MQDH)的 Tools 或 Meta 开发者下载页获取并安装;Unity 中在 Edit > Project Settings > XR Plug-in Management 启用 Meta XR Simulator 为活动运行时,Unreal 中在 Project Settings > Plugins > Meta XR 启用 XR Simulator 选项,然后在编辑器按 Play 运行。

适用场景:交互测试、自动化回归测试、无头 CI/CD 流水线。

限制:不复制 Quest 硬件性能,无法做性能与热节流分析;手部追踪为离散预设而非连续追踪;透视为合成数据;部分平台 API 返回模拟数据;无触觉反馈;渲染分辨率、注视点渲染与刷新率与真机不同;macOS 支持有限。发布前须在实体 Quest 硬件上做最终验证。

常见问题:其他 OpenXR 运行时(SteamVR、Windows Mixed Reality、Oculus PC 应用)会抢占调用,需将模拟器设为活动运行时;Unity 中启用模拟器不会自动禁用 Oculus 或 OpenXR 加载器,需手动禁用其他加载器;企业杀毒软件可能阻断本地 IPC。