Share via


KinectAudioSource.SoundSourceAngle Property

Kinect for Windows 1.5, 1.6, 1.7, 1.8

Gets the sound source angle (in degrees), which is the direction that sound is arriving from a sound source. The range is [-50, +50].

Syntax

public double SoundSourceAngle { get; }
'Declaration
Public ReadOnly Property SoundSourceAngle As Double 

Property Value

Type: Double
The sound source angle.

Remarks

The sound source angle and the beam angle are both defined from the sensor location. Both angles are defined in the x-z plane of the sensor perpendicular to the z-axis of the sensor. However, the two angles have completely different functionality.

  • The sound source angle identifies the direction (not the location) of a sound source. The range of the angle is [-50, +50] degrees.
  • The beam angle identifies a preferred direction for the sensor to listen. The angle is one of the following values (in degrees): {-50, -40, -30, -20, -10, 0, +10, +20, +30, +40, +50}. The sign determines direction:
    • A negative number indicates the audio source is on the right side of the sensor (left side of the user)
    • A positive value indicates the audio source is on the left side of the sensor (right side of the user)
    • 0 indicates the audio source is centered in front of the sensor

Both angles (beam and sound source) are updated continuously once the sensor has started streaming audio data (when the Start method is called).

Use the sound source angle to tell the choose the beam angle if you want to capture a particular sound source.

Requirements

Namespace: Microsoft.Kinect

Assembly: Microsoft.Kinect (in microsoft.kinect.dll)

See Also

Reference

KinectAudioSource Class
KinectAudioSource Members
Microsoft.Kinect Namespace