Class

ARConfiguration

An object that defines the particular ARKit features you enable in your session at a given time.

Declaration

class ARConfiguration : NSObject

Overview

ARConfiguration defines a base class for the different options your AR experience can have. You don't allocate ARConfiguration yourself; instead, you instantiate one of its subclasses.

Choose Your Configuration

To implement the features of your AR experience, you create one of the following subclasses and run it on your session via run(with:). A session can run only one configuration at a time, so choose the one that best facilitates the desired AR experience.

ARWorldTrackingConfiguration: Tracks the device's position and orientation relative to any surfaces, people, or known images and objects that ARKit may find and track using the device's back camera.
ARBodyTrackingConfiguration: Enables you to track a person, planes, and images, using the device's back camera.
AROrientationTrackingConfiguration: Tracks only the device's orientation using the back camera.
ARImageTrackingConfiguration: Tracks only known images you provide via trackingImages, using the device's back camera.
ARFaceTrackingConfiguration: Tracks only faces in the device's selfie camera, including their movement and facial expressions.
ARObjectScanningConfiguration: Uses the back camera to collect high-fidelity data about specific objects you want your app to recognize later, at runtime.
ARPositionalTrackingConfiguration: Tracks only the device's position in 3D space.

Choose Frame Features

Some configurations support sub-features relating to a session's frame. You enable these features by setting the following flags in the configuration's frameSemantics:

bodyDetection: Enables 2D human body tracking.
personSegmentation: Enables people occlusion.
personSegmentationWithDepth: Enables people occlusion based on whether the people in the camera feed are closer to the camera than the virtual content.

Switch Configurations at Runtime

When you want to toggle features like plane detection, frame semantics, and environment texturing, you switch your configuration at runtime by calling run(with:) on your existing session. Where possible, ARKit maintains all the information that was collected during the session under the prior configuration, such as information about the physical environment, and anchors.

Topics

Verifying Device Support

class var isSupported: Bool

A Boolean value indicating whether the current device supports this session configuration class.

Checking Frame Features

class func supportsFrameSemantics(ARConfiguration.FrameSemantics) -> Bool

Checks whether a particular feature is supported.

Enabling Frame Features

var frameSemantics: ARConfiguration.FrameSemantics

The set of active semantics on the frame.

struct ARConfiguration.FrameSemantics

Types of optional frame features you can enable in your app.

Configuring the AR Session

var isLightEstimationEnabled: Bool

A Boolean value specifying whether ARKit analyzes scene lighting in captured camera images.

var worldAlignment: ARConfiguration.WorldAlignment

A value specifying how the session maps real-world device motion into a 3D scene coordinate system.

enum ARConfiguration.WorldAlignment

Options for how ARKit constructs a scene coordinate system based on real-world device motion.

Managing Video Capture Options

var videoFormat: ARConfiguration.VideoFormat

The video capture size and frame rate to be used for sessions running this configuration.

class var supportedVideoFormats: [ARConfiguration.VideoFormat]

The set of video capture formats available on the current device.

class ARConfiguration.VideoFormat

A video size and frame rate specification for use with an AR session.

Recording Audio

var providesAudioData: Bool

A Boolean value that specifies whether to capture audio during the AR session.

Relationships

Inherits From

NSObject