Instance Property


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


@property(nonatomic) BOOL automaticallyConfiguresApplicationAudioSession;


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

The value of this property defaults to YES, 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 NO, 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


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