用途:在 visionOS 27 上构建和调试 HandTrackingProvider,处理手部锚点、手部关节变换、自定义手势与手部驱动的交互。若只需高层交互,应先确认任务是否真的需要原始手部/关节数据;普通点击、拖拽或注视目标 UI 应优先使用 SwiftUI 或 RealityKit 手势。
主要能力:加载共享会话指南与手部提供者参考;添加手部隐私说明并请求提供者所需的授权;将关节处理放在模型层,仅在需要处桥接到 SwiftUI 或 RealityKit。参考资料按需使用:session-basics.md 用于 ARKitSession、授权、事件处理或清理;hand-tracking-provider.md 用于 HandTrackingProvider、HandAnchor 或关节变换;anchor-processing.md 用于把手部锚点更新并入应用状态;realitykit-bridge.md 用于可视化手部或驱动 RealityKit 实体。
使用方式:检查 HandTrackingProvider.isSupported;请求 HandTrackingProvider.requiredAuthorizations;在长生命周期 ARKitSession 中运行提供者;在 SwiftUI body 路径之外处理更新序列;清理时取消更新任务并停止会话。
限制与注意:不要用原始手部追踪处理平台手势已覆盖的普通交互;不要假设双手或每个关节始终被追踪;应将手部追踪被拒绝视为功能级不可用状态,而不是应用启动失败。输出应说明是否确实需要原始手部追踪、使用了哪些手部提供者参考、授权与不支持设备时的行为,以及关节处理与渲染路径。