Instance Property


A Boolean value that indicates whether the capture session automatically changes settings in the app’s shared audio session.


var automaticallyConfiguresApplicationAudioSession: Bool { get set }


This property only takes effect if the value of the usesApplicationAudioSession property is true.

The value of this property defaults to true, causing the capture session to automatically configure the app’s shared AVAudioSession instance for optimal recording. For example, if the capture session uses a device’s rear-facing camera, the audio session’s microphone and polar pattern will be set for optimal recording of sound from that direction. Note that the audio session’s original state is not restored after capture finishes.

If you set this property’s value to false, your app is responsible for selecting appropriate audio session settings. Recording may fail if the audio session’s settings are incompatible with the capture session.

See Also

Sharing the Application’s Audio Session

var usesApplicationAudioSession: Bool

Indicates whether the capture session will make use of the app’s shared audio session.