Android.Media.Audiofx.Virtualizer.GetSpeakerAngles Method
Queries the virtual speaker angles (azimuth and elevation) for a combination of a channel mask and virtualization mode.

Syntax

[Android.Runtime.Register("getSpeakerAngles", "(II[I)Z", "GetGetSpeakerAngles_IIarrayIHandler")]
public virtual bool GetSpeakerAngles ([Android.Runtime.GeneratedEnum] Android.Media.ChannelIn inputChannelMask, [Android.Runtime.GeneratedEnum] VirtualizationMode virtualizationMode, int[] angles)

Parameters

inputChannelMask
the channel mask of the content to virtualize.
virtualizationMode
the mode for which virtualization processing is to be performed, one of Virtualizer.VIRTUALIZATION_MODE_BINAURAL, Virtualizer.VIRTUALIZATION_MODE_TRANSAURAL.
angles
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 3*i in the array contains the speaker identification (e.g. Android.Media.AudioFormat.CHANNEL_OUT_FRONT_LEFT),
  • the element at index 3*i+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

Documentation for this section has not yet been entered.

Exceptions

TypeReason
!:NoType:IllegalStateException
!:NoType:IllegalArgumentException
Java.Lang.UnsupportedOperationException
Java.Lang.IllegalStateException
Java.Lang.IllegalArgumentException

Remarks

Queries the virtual speaker angles (azimuth and elevation) for a combination of a channel mask and virtualization mode. If the virtualization configuration (mask and mode) is supported (see Virtualizer.CanVirtualize(Android.Media.ChannelIn, Android.Media.Audiofx.VirtualizationMode), the array angles will contain upon return the definition of each virtual speaker and its azimuth and elevation angles relative to the listener.

Note that in some virtualizer implementations, the angles may be strength-dependent.

[Android Documentation]

Requirements

Namespace: Android.Media.Audiofx
Assembly: Mono.Android (in Mono.Android.dll)
Assembly Versions: 0.0.0.0
Since: Added in API level 9