Azure Kinect and Femto Bolt Examples for Unity

This is a set of Azure Kinect and Femto Bolt camera examples that use several major scripts, grouped in one folder. The package contains over thirty five demo scenes. In addition to the Azure Kinect, Femto Bolt and Femto Mega sensors, the K4A-package supports the "classic" Kinect-v2 (aka Kinect for Xbox One), as well as iPhone-Pro LiDAR sensors.

Web | Forum | Twitter | Docs | Tips&Tricks

The avatar-demo scenes show how to utilize Kinect-controlled avatars in your scenes, gesture demo – how to use discrete and continuous gestures in your projects, fitting room demos – how to overlay or blend the user’s body with virtual models, background removal demo – how to display user silhouettes on virtual background, point cloud demos - how to present the real environment or users as meshes in your scene, etc. Short descriptions of all demo-scenes are available in the online documentation.

This package works with Azure Kinect, Femto Bolt and Femto Mega sensors, Kinect-v2 (aka Kinect for Xbox One) and iPhone-Pro LiDAR sensors. It can be used with all versions of Unity – Free, Plus & Pro.

How to Run the Demo Scenes:

1a. (Azure Kinect) Download and install the latest release of Azure-Kinect Sensor SDK. The download link is below. Then open 'Azure Kinect Viewer' to check, if the sensor works as expected.

1b. (Femto Bolt and Mega) Download and unzip the latest release of Orbbec Viewer, as well as Orbbec SDK K4A Wrapper. The download links are below. Then open first the 'Orbec Viewer' and then 'K4A Viewer' to check, if the sensor works as expected.

2. (Azure Kinect and Femto Bolt/Mega) Follow the instructions on how to download and install the latest release of Azure-Kinect Body Tracking SDK. It is used by all body-tracking related scenes, regardless of the camera. The download link is below.

3. (Kinect-v2) Download and install Kinect for Windows SDK 2.0. The download link is below.

4. (iPhone Pro) For integration with the iPhone Pro's LiDAR sensor, please look at this tip.

5a. Import this package into a new Unity project. 

5b. (Femto Bolt and Mega) Please look at this tip on what to do next.

6. Open ‘File / Build settings’ and switch to ‘PC, Mac & Linux Standalone’, Target platform: ‘Windows’ & Architecture: 'Intel 64 bit'.

7. Make sure that 'Direct3D11' is the first option in the ‘Auto Graphics API for Windows’-list setting, in 'Player Settings / Other Settings / Rendering'.

8. Open and run a demo scene of your choice from a subfolder of the 'AzureKinectExamples/KinectDemos'-folder. Short descriptions of all demo-scenes are available in the online documentation.

* The latest Azure Kinect Sensor SDK (v1.4.1) can be found here.

* The latest release of Orbbec Viewer can be found here.

* The latest Orbbec SDK K4A-Wrapper (K4A Viewer) can be found here.

* The latest Azure Kinect Body Tracking SDK (v1.1.2) can be found here.

* Older releases of Azure Kinect Body Tracking SDK can be found here.

* Instructions how to install the body tracking SDK can be found here.

* Kinect for Windows SDK 2.0 can be found here.

* RealSense SDK 2.0 can be found here.

One request:

Please don't share this package or its demo scenes in source form with others, or as part of public repositories, without my explicit consent.

Troubleshooting:

* If Unity editor freezes or crashes at the scene start, please make sure the path where the Unity project resides does not contain any non-English characters.

* If you get errors like ‘Texture2D’ does not contain a definition for ‘LoadImage’ or ‘Texture2D’ does not contain a definition for ‘EncodeToJPG’, please open the Package Maneger, select ‘Built-in packages’ and enable ‘Image conversion’ and ‘Physics 2D’ packages.

* If you get syntax errors in console like "The type or namespace name 'UI' does not exist...", please open the Package manager (menu Window / Package Manager) and install the 'Unity UI' package. The UI elements are extensively used in the K4A-asset demo scenes.

* If the Azure Kinect sensor cannot be started, because StartCameras()-method fails, please check again #6 in 'How to run the demo scenes'-section above.

* If you get a 'Can't create the body tracker'-error message, please check again #2 in 'How to run the demo scenes'-section above.

* Femto Bolt and Mega support: If you need to replace Azure Kinect with (or prefer to use) Orbbec's Femto Bolt or Mega sensors, please follow this tip.

* iPhone-Pro support: If you like to use the K4A-asset together with the iPhone-Pro's LiDAR sensor, please look at this tip.

* RealSense support is deprecated. The Cubemos skeleton tracking is not available anymore. For more information please look at this tip.

* If there are errors like 'Shader error in [System 1]...', while importing the K4A-asset, please note this is not an error, but rather shader issues due to missing HDRP & VFX packages. You only need these packages for the VFX point-cloud demo. All other scenes should be started without any issues.

* If there are compilation errors in the console, or the demo scenes remain in 'Waiting for users'-state, make sure you have installed the respective sensor SDKs and the other needed components. Please also check, if the sensor is connected.

* For other known issues, please look here.

Documentation, Tips & Tricks:

* The basic documentation is available in the Readme-pdf file in the package.

* The online documentation is available here.

* Many K4A-package tips, tricks and examples are available here.

Third-Party Software:

This asset uses Azure Kinect Sensor SDK under MIT License, RealSense SDK 2.0 under Apache License Version 2.0 and Kinect SDK 2.0 under Microsoft Kinect for Windows v2 SDK License. See Third-Party Notices.txt file in the package for details.