AI-generated Key Takeaways
-
All AR processes happen inside an ARCore session, which is the main entry point to the ARCore API and manages the AR system state.
-
A session enables the app to receive frames providing access to the camera image and device pose.
-
Sessions can be configured to use features like Cloud Anchors, Augmented Faces, and the ARCore Geospatial API.
-
To use the Cloud Anchors or Geospatial API, you need to create and set a
GARSessionConfigurationwith the relevant mode property. -
Creating a session in iOS involves creating a
GARSession, setting a delegate, creating and running anARSession, setting anARSessionDelegate, and passing AR frames to theGARSession.
Configure an ARCore session to build AR experiences for your app.
What is a session?
All AR processes, such as motion tracking,
environmental understanding, and lighting estimation, happen inside an ARCore
session. GARSession is the main entry point to the ARCore
API. It manages the AR system state and handles the session lifecycle, allowing
the app to create, configure, start, or stop a session. Most importantly, it
enables the app to receive frames that allow access to the camera image and
device pose.
The session can be used to configure the following features:
Configure a session
To use either the Cloud Anchors API or the
Geospatial API, you have to create a
GARSessionConfiguration
with either the cloudAnchorMode or geospatialMode property:
create a
GARSessionConfigurationand set thegeospatialModeorcloudAnchorModeproperty for it.Use
setConfiguration:error: (GARSession)to set the configuration.
Create a session in iOS
- Create a
GARSession. - Set a
GARSessionDelegateto get callbacks from hosting and resolving operations. - Create and run an
ARSession. - Set an
ARSessionDelegate. - Pass
ARFrames to theGARSessionin thesession:didUpdateFrame:method.