SuperAPI AI 工具集

pmndrs-xr

前端与建站

查看项目

更新于 10-16 08:07

技能介绍

用途:面向使用 React Three Fiber 和 React Three XR/uikit/handle 构建的 WebXR 应用,提供构建、修改、调试与验证的工作流指引,涵盖 AR、VR、空间交互、指针、控制器、手部追踪、命中测试、传送、图层、锚点与 uikit 等方向。

主要能力与用法:编辑前先检查应用结构与包管理器;若工作区为空,先搭建最小可运行切片(包含 package 脚本、src/main、src/App、样式与 vitexec/play),确保可构建后再扩展场景。架构上使用 @react-three/xr 配合 <Canvas> 与 <XR store={store}>,并通过真实用户手势(例如 DOM 按钮调用 store.enterAR() 或 store.enterVR())进入 AR/VR。沉浸式状态、分数、清单、报告与控件应放在 3D/WebXR 场景内,DOM 仅用于初始入场按钮与可选的桌面回退,不作为头显 UI。交互应基于真实空间输入:指针事件、文档化的 handle 组件、控制器/手姿态、近场交互、控制器 select 事件、hit-test 或锚点。编辑、配置或装配任务使用可见 handle/gizmo 或可抓取特性,并通过对象变换变化验证拖拽、平移、旋转与吸附行为。

验证:XR 体验需进行实时 XR 走查,通过路径应能进入模拟 XR 会话、移动头显/视角、瞄准控制器、与可见场景内目标交互、录制视频并断言视图构成。参考资料按需读取最小相关页面:架构与包选择、场景内 UI 与视觉质量、用例模式、交互模式、vitexec/IWER 验证、依赖版本陷阱;上游文档含入门、store、交互、origin/teleport、AR 特性(anchors、dom-overlay、hit-test、object-detection)、handles 与完整索引。不确定时可检索引用。

限制与要求:避免先用长设计或大范围翻查 node_modules;先读所需参考再实现并验证最小真实路径。避免占位立方体演示,应使用领域相关环境、可识别对象、光照材质变化与可见反馈。桌面回退应保持可用但不得作为 XR 行为的证明。不得削弱验证来通过;输入未命中应修正几何、射线姿态、就绪状态、遮挡或事件处理。代码文件用补丁/文件编辑操作,不用 shell heredoc。完成前确认存在 createXRStore 与面向用户的入场、<XR store={store}>、场景内 XR UI、真实交互及构建与浏览器/XR 验证。具体版本、收费与平台支持资料暂未提供。