Share via

KinectInteraction Native API

  • Article

Kinect for Windows 1.7, 1.8

KinectInteraction Native API

The KinectInteraction native API is intended for advanced applications.

Note

The libraries and assemblies for these features are NOT installed into the GAC and System32 directories. They must be distributed with the application.

The native API provides 2 interfaces:

  • INuiInteractionStream, which is the stream providing all computed interactions, and is also used to access the hand pointer and user information for tracked users.

  • INuiInteractionClient, which provides a method to report which control the user is currently targeting.

The API also provides a function to create and initialize an interaction stream: NuiCreateInteractionStream.

These interfaces are defined in the KinectInteraction170_*.dll (where * is 32 or 64, depending on the architecture you are targeting).

INuiInteractionStream

The basic model for INuiInteractionStream is that a set of interaction frames, built from frames of the depth stream and skeleton stream, are provided to the application. This interaction frame provides information on the hand pointer target, and whether the hand is neutral, gripping, or releasing. This interaction frame also provides, as a part of the target information, whether the hand cursor is pressed or not.

INuiInteractionClient

INuiInteractionClient is the UX client hook into the interaction stream. This interface provides a method, GetInteractionInfoAtLocation, which provides the information about which control the hand pointer is currently targeting.