SuperAPI AI 工具集

quest-browser-webxr

通用与其它

查看项目

更新于 11-17 00:31

技能介绍

Quest Browser WebXR 是 iwsdk-webxr-skills 中的浏览器层技能,作者 Navid Mirzaaghazadeh,采用 MIT 许可。它面向任何 WebXR 技术栈(IWSDK、three.js、A-Frame、Babylon、原生 WebGL),整理 Meta Quest Browser 对 WebXR 的支持情况与使用方式。

用途

该技能用于了解 Quest Browser 支持哪些 WebXR 特性、如何建立会话、如何在头显上测试,以及如何做性能调优。它提供一份带来源的功能矩阵,其中包含 Meta VR Glasses 列。

主要能力

功能矩阵覆盖:VR 会话(requestSession('immersive-vr'))、透视 AR('immersive-ar')、手部追踪、眼动注视('gaze-tracking')、命中测试、锚点与持久锚点、平面检测、网格检测、深度感知、图层、固定注视点渲染、帧率、Multiview、Space Warp、系统键盘、Touch Pro 控制器、摄像头访问,以及 DOM overlay 与 WebGPU XR。矩阵同时标注 Quest Browser 状态、Meta VR Glasses 状态与 Meta 来源。

文档还包含:原始 WebXR 会话设置代码示例;不使用 IWSDK 时的注视处理方式(在 inputSources 中查找 targetRayMode === 'gaze',由手部 select 事件提交选择);帧率设置代码;渲染缩放与运行时注视点渲染说明;生命周期与输入焦点状态表(visible、visible-blurred、hidden);头显测试命令;无头显时的模拟方案;以及性能预算与优化顺序。

使用方式

会话设置示例:

const mode = 'immersive-vr'; // or 'immersive-ar' for passthrough if (!(await navigator.xr?.isSessionSupported(mode))) return showNoXrMessage(); const session = await navigator.xr.requestSession(mode, { requiredFeatures: ['local-floor'], optionalFeatures: ['hand-tracking', 'layers', 'medium-fixed-foveation-level'], // AR extras: 'hit-test', 'anchors', 'plane-detection', 'mesh-detection', // 'depth-sensing' with depthSensing: { usagePreference: ['gpu-optimized'], dataFormatPreference: ['float32'] } // Eye gaze (VR Glasses): 'gaze-tracking' and 'eye-tracking', always optional });

帧率设置示例:

const rates = session.supportedFrameRates; // e.g. Float32Array; undefined if unsupported if (rates?.includes(90)) await session.updateTargetFrameRate(90); console.log('nominal rate', session.frameRate);

头显测试命令:

metavr device list # developer mode + USB, see hz-quest-verify-first metavr adb reverse tcp:8081 tcp:8081 # headset localhost:8081 -> dev machine metavr device browser https://localhost:8081 # open it in Browser (IWSDK prints its port)

DevTools: desktop Chrome -> chrome://inspect/#devices -> inspect the tab

metavr log --level E # device log; hz-vr-debug has filtering recipes

无头显时可用 IWSDK 开发服务器内的 IWER,或 Chrome/Edge 的 Immersive Web Emulator 扩展;Spector.js 仅限桌面。VR Glasses 硬件上市前可用 IWER 的 metaVRGlasses 配置,或在 Quest 3/3S/Pro 上启用 metavr device fov-sim。

适用场景

适用于为 Quest 浏览器开发 WebXR 应用的开发者,包括 VR 与透视 AR 体验、手部追踪与注视输入、场景理解(平面/网格/深度)、性能调优,以及为 Meta VR Glasses 做前瞻适配。

限制

Meta 各特性 WebXR 页面大多未标注日期,且早于其 2026-07 的 web-docs 重写;混合现实页面仍只列出 Quest 2 与 Quest Pro,且均未提及 Meta VR Glasses(检查于 2026-10-17)。设备列表应视为下限,需在运行时检测特性,关键功能需通过 metavr 文档搜索与头显测试确认。VR Glasses 列中标注“unverified”表示需在运行时检测并在硬件上市(2027 年春季)后测试。Space Warp 需 chrome://flags 开关,Store 用户无法使用。Meta 未提供 WebXR 专用的绘制调用或三角形预算。模拟器无法覆盖性能、舒适度与部分输入,最终需在硬件上完成验证。

该技能还涉及相关交接:IWSDK API 与功能标志、IWSDK 应用头显测试、IWSDK 性能调优、Horizon 商店发布打包。