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.