---
title: "AudioSessionSetActive(_:)"
framework: audiotoolbox
role: symbol
role_heading: Function
path: "audiotoolbox/audiosessionsetactive(_:)"
---

# AudioSessionSetActive(_:)

Actives or deactivates your application’s audio session.

## Declaration

```swift
func AudioSessionSetActive(_ active: Bool) -> OSStatus
```

## Parameters

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

## Return Value

Return Value A result code. See Result Codes.

## Discussion

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.

## See Also

### Functions

- [AudioFileReadPackets(_:_:_:_:_:_:_:)](audiotoolbox/audiofilereadpackets(_:_:_:_:_:_:_:).md)
- [AudioComponentGetIcon(_:_:)](audiotoolbox/audiocomponentgeticon(_:).md)
- [AudioComponentGetLastActiveTime(_:)](audiotoolbox/audiocomponentgetlastactivetime(_:).md)
- [AudioHardwareServiceAddPropertyListener(_:_:_:_:)](audiotoolbox/audiohardwareserviceaddpropertylistener(_:_:_:_:).md)
- [AudioHardwareServiceGetPropertyData(_:_:_:_:_:_:)](audiotoolbox/audiohardwareservicegetpropertydata(_:_:_:_:_:_:).md)
- [AudioHardwareServiceGetPropertyDataSize(_:_:_:_:_:)](audiotoolbox/audiohardwareservicegetpropertydatasize(_:_:_:_:_:).md)
- [AudioHardwareServiceHasProperty(_:_:)](audiotoolbox/audiohardwareservicehasproperty(_:_:).md)
- [AudioHardwareServiceIsPropertySettable(_:_:_:)](audiotoolbox/audiohardwareserviceispropertysettable(_:_:_:).md)
- [AudioHardwareServiceRemovePropertyListener(_:_:_:_:)](audiotoolbox/audiohardwareserviceremovepropertylistener(_:_:_:_:).md)
- [AudioHardwareServiceSetPropertyData(_:_:_:_:_:_:)](audiotoolbox/audiohardwareservicesetpropertydata(_:_:_:_:_:_:).md)
- [AudioOutputUnitGetHostIcon(_:_:)](audiotoolbox/audiooutputunitgethosticon(_:_:).md)
- [AudioOutputUnitPublish(_:_:_:_:)](audiotoolbox/audiooutputunitpublish(_:_:_:_:).md)
- [AudioSessionAddPropertyListener(_:_:_:)](audiotoolbox/audiosessionaddpropertylistener(_:_:_:).md)
- [AudioSessionGetProperty(_:_:_:)](audiotoolbox/audiosessiongetproperty(_:_:_:).md)
- [AudioSessionGetPropertySize(_:_:)](audiotoolbox/audiosessiongetpropertysize(_:_:).md)
