KinectAudioSource.BeamAngle Property
Kinect for Windows 1.5, 1.6, 1.7, 1.8
Gets the beam angle (in degrees), which is the direction the sensor is set for listening. The values are: {-50, -40, -30, -20, -10, 0, +10, +20, +30, +40, +50}.
public double BeamAngle { get; }
'Declaration
Public ReadOnly Property BeamAngle As Double
Type: Double
The beam angle.
To capture audio, the sensor receives sounds from every direction. However, like the cone of light from a lighthouse where the light is the brightest, the audio capture hardware has an imaginary cone that is able to capture audio signals the best. Audio waves that propagate through the length of the cone can be separated from audio waves that travel across the cone. If you point the cone in the direction of the audio that your application is most interested in capturing, you can improve the ability to capture and separate that audio source from other competing audio sources. Therefore, use the beam angle to set the direction of the imaginary cone to improve your ability to capture a specific audio source.
Similar to the sound source angle, the beam angle is also defined in the x-z plane of the sensor perpendicular to the z-axis. The beam angle and the sound source angle are both updated continuously once the sensor has started streaming audio data (when the Start method is called).
This property corresponds to the DirectX Media Object's MFPKEY_WMAAECMA_FEATR_MICARR_BEAM property key. Note that values for the property key are integers ranging from zero to ten, with the value of five representing the center beam.
Namespace: Microsoft.Kinect
Assembly: Microsoft.Kinect (in microsoft.kinect.dll)
KinectAudioSource Class
KinectAudioSource Members
Microsoft.Kinect Namespace