Selects the preferred directivity configuration for the data source.
- iOS 7.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
The directivity configuration to use.
On input, a pointer to an error object. If an error occurs, the pointer is an
NSErrorobject that describes the error. If you don’t want error information, pass in
YES if a request was successfully made, otherwise
Calling this method requests a change to the selected polar pattern. To determine whether the change has taken effect, inspect the
If the data source and its owning port are in use, using this method to change the directivity configuration is likely to result in a route reconfiguration.
Set a preferred polar pattern only after setting the audio session’s category and mode, and activating the session.