Instance Property


The preferred input port for audio routing.


@property(readonly) AVAudioSessionPortDescription *preferredInput;


The value of this property indicates the input port selected using the setPreferredInput:error: method. To see the actual current input port, use the currentRoute property. Returns nil if no preference has been set or if the previously set preferred input is no longer available.

See Also

Working with Audio Routes


An object describing the current audio input and output route.


A Boolean value indicating whether an audio input path is available.


An array of input ports available for routing.

- setPreferredInput:error:

Sets the preferred input port for audio routing.


An array of available data sources for the audio session’s current input port.


The currently selected input data source.

- setInputDataSource:error:

Selects a data source for the audio session’s current input port.


An array of available output data sources for the current audio route.


The currently selected output data source.

- setOutputDataSource:error:

Sets the output data source for an audio session.

- overrideOutputAudioPort:error:

Temporarily changes the current audio route.


The current routing policy.

- setCategory:mode:routeSharingPolicy:options:error:

Sets the session category, mode, route sharing policy, and options.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software