Enumeration

Audio Route Change Reasons

Identifiers for the various reasons that an audio route can change while your app is running.

Declaration

enum : unsigned int {
    ...
};

Overview

You encounter these identifiers as values in the CFDictionaryRef object passed to your property listener callback function when it is listening for audio route changes. See the description for kAudioSessionProperty_AudioRouteChange.

Topics

Constants

kAudioSessionRouteChangeReason_Unknown

The audio route changed but the reason is not known.

kAudioSessionRouteChangeReason_NewDeviceAvailable

A new audio hardware device became available; for example, a headset was plugged in.

kAudioSessionRouteChangeReason_OldDeviceUnavailable

The previously-used audio hardware device is now unavailable; for example, a headset was unplugged.

kAudioSessionRouteChangeReason_CategoryChange

The audio session category has changed.

kAudioSessionRouteChangeReason_Override

The audio route has been overridden. For example, while using the kAudioSessionCategory_PlayAndRecord category, output audio has been redirected to the speaker using the kAudioSessionProperty_OverrideAudioRoute property.

kAudioSessionRouteChangeReason_NoSuitableRouteForCategory

There is no audio hardware route for the audio session category; for instance, the kAudioSessionCategory_RecordAudio is set but there is no audio input device.