该技能用于系统诊断 Apple RealityKit 常见问题,覆盖实体、锚点、手势、性能、材质、物理、多人同步及模拟器与真机差异等场景。
主要能力:按症状给出排查路径。例如实体不可见时,依次检查是否加入场景、是否含 ModelComponent、缩放是否为零、位置与朝向、是否启用、是否锚定、材质是否透明等;锚点不追踪时检查会话、SpatialTrackingSession 配置、锚点类型、minimumBounds、设备支持与环境光线;手势无响应时检查 CollisionComponent、visionOS 的 InputTargetComponent、手势是否挂在 RealityView 上;性能问题检查实体数量、资源是否共享、每帧是否新建组件、碰撞体是否为网格、物理体数量与面数;材质异常检查光照、baseColor、metallic、纹理语义、面剔除与混合;物理失效检查双方碰撞组件、PhysicsBodyComponent、碰撞分组、物理模式及是否同锚点;同步失败检查 SynchronizationComponent、多设备连接、组件是否 Codable、所有权与世界锚点。还区分模拟器正常而真机崩溃的 Metal、内存与 AR 场景。
使用方式:按文档所示启用调试可视化,如 arView.debugOptions 中 .showStatistics、.showPhysics、.showAnchorOrigins、.showAnchorGeometry,文档称首次启用耗时约 10 秒;并可使用所附 diagnoseVisibility、diagnoseGesture 等快速诊断代码打印实体状态。
限制:仅针对 RealityKit;相关架构模式可参考 axiom-realitykit,API 参考可参考 axiom-realitykit-ref;部分平台与硬件要求(如 A12+、TrueDepth、LiDAR)为知识要点,具体支持情况暂未提供。