Arkit Spatial Tracking Providers

ARKit Spatial Tracking Providers

Quick Start

1. Identify the spatial signal: device/world pose, detected planes, scene meshes, room state, or shared coordinates.
2. Load the shared ARKit session guidance first, then only the provider reference that matches the task.
3. Keep anchor reconciliation in a model layer; bridge to RealityKit only after model state is stable.
4. For provider selection across unrelated ARKit capabilities, switch back to $arkit-visionos-developer.

Load References When

Workflow

1. Check provider support and required authorizations before constructing the run list.
2. Build the provider list explicitly; do not hide unrelated providers in a shared session helper.
3. Start the long-lived ARKitSession, observe session.events, and cancel update tasks on teardown.
4. Recreate provider instances before retrying run(_:) after a thrown run or stopped provider state.

Guardrails

• Use WorldTrackingProvider for world-locked content and pose queries, not for surface semantics that belong to plane or mesh providers.
• Treat plane, mesh, room, and shared-coordinate data as different coordinate contracts; do not merge them without an explicit model-layer boundary.
• Do not block the main actor while awaiting provider update sequences.

Output Expectations

Provide:

• the spatial provider set chosen
• which shared and provider references were used
• the authorization and session lifecycle model
• the anchor state model and RealityKit bridge if applicable