visionOS 2.0 – Persist room‑fixed RealityKit entities on walls across app launches (WorldAnchor?)

I want to let users place 3D “artworks” on detected walls and have them reappear in exactly the same real‑world spot after quitting and relaunching the app (like widgets do, but for my own entities).

Environment:

  • Xcode 26, visionOS 2.0, RealityKit + ARKitSession/WorldTrackingProvider
  • Entities are parented to a holder that’s aligned to a wall via plane/mesh raycasts

What I’ve tried:

  • Create a WorldAnchor at placement, save UUID + full 4×4 transform
  • On next launch, re-create the WorldAnchor (or set the saved transform) and attach the entity
  • Gate restore on relocalization/mesh updates and disable all raycast/search after restore

Issue:

  • After relaunch, placement still resolves relative to current device pose, not the same wall position.

Questions:

1) Is there a public API in visionOS 2.0 to persist app‑managed world anchors across sessions (room‑fixed), e.g., AnchorStore or equivalent?

2) If not, what’s the recommended pattern to reliably restore wall‑anchored content?

3) Are persistence features mentioned for widgets/windows available to third‑party RealityKit entities?

Apple Vision Pro

Posted on Oct 28, 2025 7:38 AM

Reply
1 reply

visionOS 2.0 – Persist room‑fixed RealityKit entities on walls across app launches (WorldAnchor?)

Welcome to Apple Support Community
A forum where Apple customers help each other with their products. Get started with your Apple Account.