SuperAPI AI 工具集

xb-add-world-sensing

通用与其它

查看项目

更新于 10-15 21:54

技能介绍

用途:在 XR Blocks 应用中构建完整的感知行为,使物理或场景信号进入应用、成为当前状态并产生可观察反应,例如平面、场景网格、深度、遮挡、世界碰撞证据、对象检测等。

主要能力与流程:

  1. 编写传感器契约:明确信号名称、频率、可观察反应、数据新鲜度、权限、目标运行时,以及不支持、拒绝、预热中、空、过期、失败等状态的处理方式。查阅 references/branches.md,选择能提供该信号的最窄分支,只读该分支的手册与示例。
  2. 验证所选分支:在 ../../src/xrblocks.ts 及其实现中核对每个计划使用的符号,检查对应手册、模板或示例,记录选项、权限、WebXR 会话特性、可选依赖、模拟器保真度与真机检查,再改应用代码。
  3. 将证据连接到应用状态:在 xb.init(options) 之前配置分支,应用行为放在 xb.Script 中,由 XR Blocks 管理传感器与渲染更新循环。显式检测需防止失控的并发请求并显示等待状态;连续检测用同一个 client 对象调用 start(client) 与 stop(client)。把成功转为所需反应;把空数组、null、缺失传感器数据、权限被拒、会话启动被拒、过期观测转为契约中的缺失状态;输出不再当前时清除。
  4. 保持定位与放置职责:基于射线的放置使用交互管线解析出的命中,准星只显示命中而不拥有目标数据;一次性表面放置用 xb.world.placeOnHorizontalSurface();连续跟随/朝向/环绕行为及其操作重基准使用 Placement 手册。传感器、交互解析器、准星与已放置对象各司其职。
  5. 验证与交接:构建或类型检查应用,在可用时启动指定模拟器路线,确认选项、导入、权限、检测器归属、新鲜度、结果映射、缺失状态与清理。仅当分支支持时添加确定性模拟器真值。模拟器与真机证据不同时分别给出说明,点明要呈现的信号、预期反应、空结果、过期清除、权限及合成与原生证据。

适用场景:需要把现实环境感知接入 XR 应用状态的开发工作。限制:必须按所选分支的现有源码与示例为准,具体符号、权限、API 与设备支持以资料和实际实现为准,未提供的信息暂未提供;此技能偏流程指导,不提供完整可运行示例。