用途:为 visionOS 27 构建和调试 ARKit 参考与标记追踪,涵盖 ImageTrackingProvider(已知二维图像)、ObjectTrackingProvider(三维参考对象)、BarcodeDetectionProvider(条形码,需先确认授权)以及 AccessoryTrackingProvider(受支持的配件)。
用法:先确定物理参考类型,再加载共享的 ARKit session 指南,然后加载与所选 provider 匹配的文档文件。调试运行数据流前需确认所需授权、隐私文案、entitlement 与 profile 要求。建议在修改 session 代码前先验证参考资源或目标集;先检查 provider 支持与 entitlement,再解读缺失的更新;仅申请所选 provider 集合所需的授权;按稳定 ID 存储追踪锚点,并在移除更新时清理过期模型状态。
参考文件对应:session-basics.md 用于 ARKitSession、授权、事件或销毁;anchor-processing.md 用于将参考锚点更新并入应用状态;realitykit-bridge.md 用于需要可见 RealityKit 内容时;image-tracking-provider.md、object-tracking-provider.md、barcode-detection-provider.md、accessory-tracking-provider.md 分别对应各类 provider。
限制与注意:在签名与 profile 要求得到确认前,不要把缺少条形码或配件数据(受 entitlement 管控)当作变换 bug;visionOS 27 的对象追踪在需要时优先使用逐对象高帧率配置,而非已弃用的速率设置;参考图像物理尺寸与参考对象方向须准确,源元数据错误会导致追踪不稳定。输出应包含所选参考 provider、参考资源与授权检查、使用的 provider 参考文档以及锚点协调与 RealityKit 桥接方案。具体安装命令与更多平台限制暂未提供。