<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "macCatalyst: -",
    "macOS: -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AudioToolbox",
  "identifier" : "/documentation/AudioToolbox/kAudioSessionProperty_OverrideAudioRoute",
  "metadataVersion" : "0.1.0",
  "role" : "Global Variable",
  "symbol" : {
    "kind" : "Global Variable",
    "modules" : [
      "Audio Toolbox"
    ],
    "preciseIdentifier" : "c:@Ea@kAudioSessionProperty_PreferredHardwareSampleRate@kAudioSessionProperty_OverrideAudioRoute"
  },
  "title" : "kAudioSessionProperty_OverrideAudioRoute"
}
-->

# kAudioSessionProperty_OverrideAudioRoute

Specifies whether or not to override the audio session category’s typical audio route.

```
var kAudioSessionProperty_OverrideAudioRoute: Int { get }
```

## Discussion

A write-only `UInt32` value. Can be set with one of two values: [`kAudioSessionOverrideAudioRoute_None`](/documentation/AudioToolbox/kAudioSessionOverrideAudioRoute_None), which specifies that you want to use the typical audio route; and [`kAudioSessionOverrideAudioRoute_Speaker`](/documentation/AudioToolbox/kAudioSessionOverrideAudioRoute_Speaker), when sends output audio to the built-in speaker. This property can be used only with the [`kAudioSessionCategory_PlayAndRecord`](/documentation/AudioToolbox/kAudioSessionCategory_PlayAndRecord) (or the equivalent <doc://com.apple.documentation/documentation/AVFAudio/AVAudioSession/Category-swift.struct/playAndRecord>) category.

If a headset is plugged in at the time you set this property’s value to [`kAudioSessionOverrideAudioRoute_Speaker`](/documentation/AudioToolbox/kAudioSessionOverrideAudioRoute_Speaker), the system changes the audio routing for input as well as for output: input comes from the built-in microphone; output goes to the built-in speaker.

Upon an audio route change (such as by plugging in or unplugging a headset), or upon interruption, this property reverts to its default value.

See also [`kAudioSessionProperty_OverrideCategoryDefaultToSpeaker`](/documentation/AudioToolbox/kAudioSessionProperty_OverrideCategoryDefaultToSpeaker).

---

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)