<!--
{
  "availability" : [
    "iOS: 7.0.0 -",
    "iPadOS: 7.0.0 -",
    "macCatalyst: 14.0.0 -",
    "tvOS: 17.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVCaptureSession/automaticallyConfiguresApplicationAudioSession",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVCaptureSession(py)automaticallyConfiguresApplicationAudioSession"
  },
  "title" : "automaticallyConfiguresApplicationAudioSession"
}
-->

# automaticallyConfiguresApplicationAudioSession

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

```
var automaticallyConfiguresApplicationAudioSession: Bool { get set }
```

## Discussion

This property only takes effect if the value of the [`usesApplicationAudioSession`](/documentation/AVFoundation/AVCaptureSession/usesApplicationAudioSession) property is <doc://com.apple.documentation/documentation/Swift/true>.

The value of this property defaults to <doc://com.apple.documentation/documentation/Swift/true>, causing the capture session to automatically configure the app’s shared <doc://com.apple.documentation/documentation/AVFAudio/AVAudioSession> instance for optimal recording. For example, if the capture session uses a device’s rear-facing camera, the system sets the audio session’s microphone and polar pattern for optimal recording of sound from that direction. The audio session’s original state isn’t restored after capture finishes.

If you set value to <doc://com.apple.documentation/documentation/Swift/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.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)