Returns an object encapsulating the world-tracking session's space-mapping state and set of anchors.
- iOS 12.0+
ARWorld encapsulates the state of a running
ARSession. This state includes ARKit's awareness of the physical space the user moves the device in (which ARKit uses to determine the device's position and orientation), as well as any
ARAnchor objects added to the session (which can represent detected real-world features or virtual content placed by your app). After you use this method to save a session's world map, you can assign it to a configuration's
initial property and use
run to start another session with the same spatial awareness and anchors.
By saving world maps and using them to start new sessions, your app can add new AR capabilities:
Multiuser AR experiences. Create a shared frame of reference by sending archived
ARWorldobjects to a nearby user's device. With two devices tracking the same world map, you can build a networked experience where both users can see and interact with the same virtual content.
Persistent AR experiences. Save a world map when your app becomes inactive, then restore it the next time your app launches in the same physical environment. You can use anchors from the resumed world map to place the same virtual content at the same positions from the saved session.
Before saving a world map, monitor the
world property to verify that ARKit has an adequate understanding of the user's environment, ensuring that you can reliably make use of the saved map on a different device or at a later time.
World map generation requires a world-tracking AR session. If you call this method on an
ARSession not run with
ARWorld, it invokes your completion handler immediately, providing no world map and an error.