用途:构建或扩展一个完整的 XR Blocks 应用,交付可交接的垂直切片,即用户能打开、操作并评判的最小完整体验。适用于应用脚手架、整体体验、涉及多个 SDK 领域或端到端交付的请求。
主要能力与流程:
- 编写体验契约:确定首个可见状态、主要用户动作、可观察结果、目标表面、头显输入、桌面等价方式、权限、资产、服务及不支持状态。当切片可表述为“在表面 S 上,用户执行 X,应用观察到 Y,体验变为 Z”时完成。
- 选择可执行基础:阅读 ../../CONTEXT.md,保留现有应用的交付模型。新浏览器模块应用从 ../../templates/00_basic/ 开始;打包 TypeScript 应用从 ../../templates/13_typescript_vite/ 开始。仅当某功能是核心时才选更聚焦的模板。浏览器模块在修改 import map 前阅读 references/import-maps.md,并在 ../../src/xrblocks.ts 或插件公共入口中验证每个 XR Blocks 符号。
- 构建完整切片:使用引擎自有形态,导入 three 与 xrblocks,继承 xb.Script,在 init() 中创建对象,在 dispose() 中释放资源,注册脚本后再初始化,帧行为放 update()。需要空间 UI、交互、世界感知或 AI 时使用对应聚焦技能。
- 准备模拟器与 XR 路径:阅读 references/simulator-and-xr-handoff.md,正常启动保持 formFactor: 'auto',为主要动作提供精确桌面模拟器路由,初始化前声明设备权限与会话特性,模拟器与 XR 共享应用状态和场景设置。
- 验证与交接:构建或类型检查入口,运行聚焦测试,环境允许时启动模拟器路由,检查模块解析、初始化、首次渲染、输入提示、处理器注册、清理及控制台输出。返回启动命令与 URL、目标表面、输入步骤、预期结果、所需权限或服务、已完成的检查及剩余真机检查。
限制:资料未提供具体收费、价格、平台支持范围或效果保证;部分步骤依赖仓库内相对路径文件与模板,需在对应代码库环境中使用。