---
title: "setActive(_:options:)"
framework: avfaudio
role: symbol
role_heading: Instance Method
path: "avfaudio/avaudiosession/setactive(_:options:)"
---

# setActive(_:options:)

Activates or deactivates your app’s audio session using the specified options.

## Declaration

```swift
func setActive(_ active: Bool, options: AVAudioSession.SetActiveOptions = []) throws
```

## Parameters

- `active`: Specify doc://com.apple.documentation/documentation/Swift/true to activate your app’s audio session, or doc://com.apple.documentation/documentation/Swift/false to deactivate it.
- `options`: An integer bit mask containing one or more constants from the doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioSession/SetActiveOptions enumeration.

## Discussion

Discussion Your app may activate a session with category playback when another app is hosting a call, for example to start a SharePlay activity. However, your app isn’t permitted to capture the microphone of the active call. note: If you attempt to activate a session with category record or playAndRecord when another app is already hosting a call, then your session fails with the error AVAudioSessionErrorInsufficientPriority. The session fails to activate if another audio session has higher priority than yours (such as a phone call) and neither audio session allows mixing. Deactivating an audio session with running audio objects stops the objects, makes the session inactive, and returns an AVAudioSession.ErrorCode.isBusy error. When your app deactivates a session, the return value is false but the active state changes to deactivate.

## Topics

### Data Types

- [AVAudioSession.SetActiveOptions](avfaudio/avaudiosession/setactiveoptions.md)

## See Also

### Activating the audio configuration

- [activate(options:completionHandler:)](avfaudio/avaudiosession/activate(options:completionhandler:).md)
- [deactivate(options:completionHandler:)](avfaudio/avaudiosession/deactivate(options:completionhandler:).md)
- [AVAudioSessionActivationOptions](avfaudio/avaudiosessionactivationoptions.md)
- [AVAudioSessionDeactivationOptions](avfaudio/avaudiosessiondeactivationoptions.md)