Share via


INuiAudioBeam Interface

Kinect for Windows 1.5, 1.6, 1.7, 1.8

Provides information about the sound source, such as sound beam direction and sound source location.

Syntax

interface INuiAudioBeam : public IUnknown

Public Methods

Name Description
AddRef Increments the reference count for an interface on an object. This method should be called for every new copy of a pointer to an interface on an object.
GetBeam Gets the beam angle, which is the direction that the sensor is actively listening.
GetPosition Provides an estimate of the sound source location, which is determined by the KinectAudio DMO's sound source localizer.
QueryInterface Retrieves pointers to the supported interfaces on an object.
Release Decrements the reference count for an interface on an object.
SetBeam Sets the beam angle, which is the direction that the sensor is actively listening.

Remarks

Kinect audio features are supported by a microphone array. Because sound from a particular audio source arrives at each microphone in the array at a slightly different time, an application can use beamforming to determine the direction of the audio source and use the microphone array as a steerable directional microphone. For more information, see Audio Stream.

For a description of IUnknown, see the IUnknown interface.

Requirements

Header: Declared in NuiSensor.h.