A Boolean value that indicates whether the capture session automatically changes settings in the app’s shared audio session.
- iOS 7.0+
- Mac Catalyst 13.0+
This property only takes effect if the value of the
uses property is
The value of this property defaults to
true, causing the capture session to automatically configure the app’s shared
AVAudio 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.