Virtualizer.GetSpeakerAngles(ChannelIn, VirtualizationMode, Int32[]) Method

Definition

Queries the virtual speaker angles (azimuth and elevation) for a combination of a channel mask and virtualization mode.

[Android.Runtime.Register("getSpeakerAngles", "(II[I)Z", "GetGetSpeakerAngles_IIarrayIHandler")]
public virtual bool GetSpeakerAngles (Android.Media.ChannelIn inputChannelMask, Android.Media.Audiofx.VirtualizationMode virtualizationMode, int[]? angles);
[<Android.Runtime.Register("getSpeakerAngles", "(II[I)Z", "GetGetSpeakerAngles_IIarrayIHandler")>]
abstract member GetSpeakerAngles : Android.Media.ChannelIn * Android.Media.Audiofx.VirtualizationMode * int[] -> bool
override this.GetSpeakerAngles : Android.Media.ChannelIn * Android.Media.Audiofx.VirtualizationMode * int[] -> bool

Parameters

inputChannelMask
ChannelIn

the channel mask of the content to virtualize.

virtualizationMode
VirtualizationMode

the mode for which virtualization processing is to be performed, one of Android.Media.Audiofx.Virtualizer.VIRTUALIZATION_MODE_BINAURAL, Android.Media.Audiofx.Virtualizer.VIRTUALIZATION_MODE_TRANSAURAL.

angles
Int32[]

a non-null array whose length is 3 times the number of channels in the channel mask. If the method indicates the configuration is supported, the array will contain upon return triplets of values: for each channel i among the channels of the mask:

  • the element at index 3i in the array contains the speaker identification (e.g. Android.Media.AudioFormat.CHANNEL_OUT_FRONT_LEFT),
  • the element at index 3i+1 contains its corresponding azimuth angle expressed in degrees, where 0 is the direction the listener faces, 180 is behind the listener, and -90 is to her/his left,
  • the element at index 3*i+2 contains its corresponding elevation angle where +90 is directly above the listener, 0 is the horizontal plane, and -90 is directly below the listener.

Returns

Boolean
Attributes

Exceptions

Remarks

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to