<!--
{
  "availability" : [
    "iOS: 4.0.0 - 7.0.0",
    "iPadOS: 4.0.0 - 7.0.0",
    "macCatalyst: 14.0.0 - 14.0.0",
    "visionOS: 1.0.0 - 1.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "AudioToolbox",
  "identifier" : "/documentation/AudioToolbox/AudioSessionSetActiveWithFlags(_:_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Audio Toolbox"
    ],
    "preciseIdentifier" : "c:@F@AudioSessionSetActiveWithFlags"
  },
  "title" : "AudioSessionSetActiveWithFlags(_:_:)"
}
-->

# AudioSessionSetActiveWithFlags(_:_:)

Activates or deactivates your application’s audio session; provides flags for use by other audio sessions.

```
func AudioSessionSetActiveWithFlags(_ active: Bool, _ inFlags: UInt32) -> OSStatus
```

## Parameters

`active`

Pass `true` to activate your application’s audio session, or `false` to deactivate it.

`inFlags`

A bitmapped value containing one or more flags from the [Audio Session Activation Flags](/documentation/AudioToolbox/1618357-audio-session-activation-flags) enumeration.

## Return Value

A result code. See Result Codes.

## Discussion

Activating your audio session may interrupt audio sessions belonging to other applications running in the background, depending on categories and priorities. Deactivating your audio session allows other, interrupted audio sessions to resume.

When another active audio session does not allow mixing, attempting to activate your audio session may fail.

---

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)