Audio Session Categories

Category identifiers for audio sessions, used to set the session's category property.

Overview

An audio session category defines a set of audio behaviors. The precise behaviors associated with each category are not under your app’s control, but rather are set by the operating system. Apple may refine category behavior in future versions of the OS. Your best strategy when selecting a category that most accurately describes your intentions for the audio behavior you want.

You can refine the configuration provided by the AVAudioSessionCategoryPlayback, AVAudioSessionCategoryRecord, and AVAudioSessionCategoryPlayAndRecord categories by using an audio session mode, as described in Audio Session Modes.

Supporting AirPlay

The audio session playback-only categories (AVAudioSessionCategoryAmbient, AVAudioSessionCategorySoloAmbient and AVAudioSessionCategoryPlayback) support both the mirrored and non-mirrored variants of AirPlay.

The audio session category AVAudioSessionCategoryPlayAndRecord supports only the mirrored variant of AirPlay while the AVAudioSessionCategoryRecord and AVAudioSessionCategoryMultiRoute categories do not allow routing to AirPlay.

Topics

Constants

AVAudioSessionCategoryAmbient

The category for an app in which sound playback is nonprimary—that is, your app can be used successfully with the sound turned off.

AVAudioSessionCategorySoloAmbient

The default audio session category.

AVAudioSessionCategoryPlayback

The category for playing recorded music or other sounds that are central to the successful use of your app.

AVAudioSessionCategoryRecord

The category for recording audio; this category silences playback audio.

AVAudioSessionCategoryPlayAndRecord

The category for recording (input) and playback (output) of audio, such as for a VoIP (Voice over Internet Protocol) app.

AVAudioSessionCategoryMultiRoute

The category for routing distinct streams of audio data to different output devices at the same time.

AVAudioSessionCategoryAudioProcessing

The category for using an audio hardware codec or signal processor while not playing or recording audio.

Deprecated