Data Source Polar Patterns

These values represent a data source’s available polar patterns.

Overview

The direction of a polar pattern is relative to the orientation of the data source. For example, you can use the cardioid pattern with a back-facing data source to more clearly record sound from behind the device, or with a front-facing data source to more clearly record sound from in front of the device (such as the user’s voice).

Topics

Constants

static let polarPatternOmnidirectional: AVAudioSession.Location

A data source that’s equally sensitive to sound from any direction.

static let polarPatternCardioid: AVAudioSession.Location

A data source that’s most sensitive to sound from the direction of the data source and is nearly insensitive to sound from the opposite direction.

static let polarPatternSubcardioid: AVAudioSession.Location

A data source that’s most sensitive to sound from the direction of the data source and is less sensitive to sound from the opposite direction.

See Also

Configuring Microphone Directivity

var selectedPolarPattern: AVAudioSession.PolarPattern?

The directivity configuration currently in use by the data source.

var supportedPolarPatterns: [AVAudioSession.PolarPattern]?

The set of directivity configurations supported by the data source.

var preferredPolarPattern: AVAudioSession.PolarPattern?

The preferred directivity configuration for the data source.

func setPreferredPolarPattern(AVAudioSession.PolarPattern?)

Selects the preferred directivity configuration for the data source.

struct AVAudioSession.PolarPattern

Constants that describe the possible polar patterns of the data source on an iOS device.