threejs-xr

WebXR

使用项目已安装的版本和现有架构。这些说明是对用户任务的补充，不授权进行无关更改或外部操作。

确认用户请求的 VR/AR 模式、目标硬件/浏览器、安全上下文以及当前已安装的 XR API。通过特性检测确认会话支持情况，并从用户手势发起会话请求。区分必需和可选的会话特性，避免某项可选能力不必要地阻碍进入会话。

由兼容 XR 的渲染器循环管理会话帧和姿势。使用 XR 摄像机/参考空间，不要用普通轨道控制器覆盖其姿势。明确米制单位、世界原点和地面假设；处理参考空间重置。

将目标射线输入与握持/控制器模型分开。按需定义 select、squeeze、左右手、断开连接和手部追踪行为。对于 AR 命中测试，处理未命中的情况，并采用明确的放置确认方式，而不是持续传送内容。

提供进入、退出、不支持、拒绝和中断状态。会话结束时恢复桌面控制和场景状态。控制资源和阴影/特效开销，以满足头显的帧率要求；测试舒适度、文本易读性和移动方式选择。

释放由会话持有的监听器和临时资源。在实际指定硬件上测试追踪、输入、放置和舒适度。模拟可以用于测试流程，但不能证明头显上的可用性。如果符合产品需求，请保留普通浏览器视图。

API 参考

有关准确的签名和特定修订版本的行为，请参阅官方文档。如果无法访问文档，请检查已安装的类型定义/源码，并说明仍存在的任何不确定之处。