Edited at

解読 : ARKit2-最初のステップ 3/3 - ARConfiguration



The abstract base class for AR session configurations.


ARConfiguration : NSObject


ARConfiguration is an abstract class; you do not create or work with instances of this class.

To run an AR session, create an instance of the concrete ARConfiguration subclass that provides the kind of augmented reality experience you want to use in your app or game. Then, set up the configuration object's properties and pass the configuration to your session's run(_:options:) method. ARKit includes the following concrete configuration classes:


Provides high-quality AR experiences that use the back-facing camera to precisely track a device's position and orientation and allow plane detection, hit testing, environment-based lighting, and image and object detection.


Provides basic AR experiences that use the back-facing camera and track only a device's orientation.


Provides basic AR experiences that use the back-facing camera and track visible images regardless of the user's environment.


Provides AR experiences that use the front-facing camera and track the movement and expressions of the user's face.


Provides for using the back-facing camera to collect high-fidelity spatial data, creating reference objects for detection in other AR experiences.

Topics : Verifying Device Support

class var isSupported: BoolA Boolean value indicating whether the current device supports this session configuration class.

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: BoolA Boolean value that specifies whether to capture audio during the AR session.


Inherits From


Conforms To