Global Variable

AVAudioSessionModeVideoChat

A mode that indicates that your app is engaging in online video conferencing.

Declaration

const AVAudioSessionMode AVAudioSessionModeVideoChat;

Discussion

Use this mode for video chat apps that use the AVAudioSessionCategoryPlayAndRecord or AVAudioSessionCategoryRecord categories. When you set this mode, the audio session optimizes the device’s tonal equalization for voice. It also reduces the set of allowable audio routes to only those appropriate for video chat.

Using this mode has the side effect of enabling the AVAudioSessionCategoryOptionAllowBluetooth category option.

For apps that use voice or video chat, also use the Voice-Processing I/O audio unit. The Voice-Processing I/O unit provides several features for VoIP apps, including automatic gain correction, adjustment of voice processing, and muting. See Voice-Processing I/O Unit for more information.

If an app uses the Voice-Processing I/O audio unit and hasn’t set its mode to one of the chat modes (voice, video, or game), the session sets the AVAudioSessionModeVoiceChat mode implicitly. On the other hand, if the app had previously set its category to AVAudioSessionCategoryPlayAndRecord and its mode to AVAudioSessionModeVideoChat or AVAudioSessionModeGameChat, instantiating the Voice-Processing I/O audio unit doesn’t cause the mode to change.

See Also

Audio Session Modes

AVAudioSessionModeDefault

The default audio session mode.

AVAudioSessionModeGameChat

A mode that the GameKit framework sets on behalf of an application that uses GameKit’s voice chat service.

AVAudioSessionModeMeasurement

A mode that indicates that your app is performing measurement of audio input or output.

AVAudioSessionModeMoviePlayback

A mode that indicates that your app is playing back movie content.

AVAudioSessionModeSpokenAudio

A mode used for continuous spoken audio to pause the audio when another app plays a short audio prompt.

AVAudioSessionModeVideoRecording

A mode that indicates that your app is recording a movie.

AVAudioSessionModeVoiceChat

A mode that indicates that your app is performing two-way voice communication, such as using Voice over Internet Protocol (VoIP).

AVAudioSessionModeVoicePrompt

A mode that indicates that your app plays audio using text-to-speech.