AudioBeam Class
Represents an audio beam.
Syntax
public ref class AudioBeam sealed : INotifyPropertyChanged
public sealed class AudioBeam : INotifyPropertyChanged
var audioBeam = WindowsPreview.Kinect.AudioBeam;
Members
AudioBeam has the following members.
Properties
| Name | Description |
|---|---|
| AudioBeamMode | Gets or sets the audio beam mode, which determines the type of beam angle. |
| AudioSource | Gets the audio source. |
| BeamAngle | Gets or sets the beam angle, which is the direction that the sensor is actively listening. |
| BeamAngleConfidence | Gets the confidence in the beam angle; the range is [0.0, 1.0], where 1 is the highest possible confidence. |
| RelativeTime | Gets the relative time of this frame. |
Methods
| Name | Description |
|---|---|
| OpenInputStream | Opens the input stream. The input stream is a mono 32-bit IEEE floating point PCM stream sampled at 16 kHz. Typical PCM values will be between -1 and +1. |
Events
| Name | Description |
|---|---|
| PropertyChanged | Occurs when a property of the AudioBeam class changes. |
Remarks
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).
Requirements
Namespace: WindowsPreview.Kinect
Metadata: windowspreview.kinect.winmd