Google Model-Viewer 项目中的 AR/MR 模式兼容性优化

在 WebXR 开发领域，Google 开源的 Model-Viewer 项目为开发者提供了便捷的 3D 模型展示和 AR/MR 体验功能。然而，近期开发者在使用 PICO 系列 VR 头显时发现，项目的 AR/MR 模式存在兼容性问题。

问题的核心在于 Model-Viewer 当前实现强制依赖 WebXR 的 Hit Test API。当运行在 PICO 4 头显的最新版 PICO 浏览器上时，由于该平台对 Hit Test API 支持不完善，导致 AR/MR 功能完全无法使用。技术团队通过调试发现，只需将 'hit-test' 从 requiredFeatures 移至 optionalFeatures，就能让基础 AR 功能恢复正常运行。

深入分析技术实现，Model-Viewer 在 ARRenderer.ts 文件中通过 WebXR 的 requestSession 方法请求 AR 会话时，将 Hit Test API 标记为必需特性。这种硬编码方式缺乏对设备能力的动态检测，不符合现代 Web 开发的渐进增强原则。更合理的做法应该是：

1. 将 Hit Test API 改为可选特性
2. 在运行时检测 API 可用性
3. 为不支持该 API 的设备提供降级方案

这种改进不仅能解决 PICO 设备的兼容性问题，还能增强项目在各种 WebXR 运行环境下的健壮性。特别值得注意的是，Hit Test API 主要用于实现基于手势或控制器的模型交互功能（如拖拽、缩放和旋转），这些高级功能在不支持该 API 的设备上可以适当降级或提供替代交互方式。

从架构设计角度看，这种改进体现了几个重要的工程原则：

• 兼容性优先：确保核心功能在尽可能多的设备上可用
• 渐进增强：在支持高级特性的设备上提供更丰富的交互体验
• 错误隔离：避免因单个 API 不可用导致整个功能模块失效

对于开发者而言，这一改进意味着 Model-Viewer 项目将能够覆盖更广泛的 XR 设备生态，包括国内日益普及的 PICO 系列头显，为 WebXR 内容的跨平台分发扫清了一个重要障碍。

从 WebXR 标准演进的角度来看，这也反映了新兴技术在实际落地过程中面临的碎片化挑战。不同厂商对标准的实现进度不一，作为上层框架，需要做好兼容层设计，才能为开发者提供一致的开发体验。