This document will take you through the steps of linking Unity with a Hand Engine data stream and visualizing this in Unity.
Requirements
-
StretchSense Hand Engine: Login to your account page at http://www.stretchsense.com/my-account or email support@stretchsense.com for details.
-
Unity Hand Engine Plugin: Download the most up-to-date Plugins from the Downloads Section of your StretchSense Account at http://www.stretchsense.com/my-account
-
Operating System: Windows 10
Setting Up your Unity Project
-
Download and Install the StretchSense Hand Engine and Unity
NOTE: In this guide, we are using the Unity version 2019.4.17f1
-
Launch Hand Engine and set up a hand
-
Launch Unity Hub and create a new project
-
Select the 3D option from the templates window, then click Create
-
Once your project is created we will bring in the Hand Engine Plugin by right-clicking in the Project Assets Directory and selecting > Import Package > CustomPackage
-
Select the HandEngineUnity_01.00.01.unitypackage
NOTE: The most up-to-date Unity package can be found in the Plugins folder you downloaded from your http://www.stretchsense.com/my-account (see image below).
-
When prompted import all of the elements in the package
NOTE: this will replace the default SampleScene
-
Under Assets, open the Scenes folder
-
Double click on HandEngine Example
-
Once the scene is reloaded your view should show the hands in Scene/Game Views and a Hand Asset in the Hierarchy
- Our Hand Engine and Unity project are now set up and the next step is to link them together. Return to the Hand Engine window and in the Streaming box enter your TCP Port number and set the switch to On. Check that the Streaming Status light in the Performer pane has turned green.
-
Move back to your Unity project and start your scene by pressing the Play icon
-
Click on each of the Hand_L or _R Assets in the Hierarchy view, this will bring up options in the Inspector view.
-
Go over to the Inspector view and check the Host and Port settings match what you set in Hand Engine in Step 11 above. You will have to check this for both hands.
NOTE: The default value for Host is 127.0.0.1 = localhost, i.e. you are running Hand Engine on the same PC that you are running Unity. If you have bound Hand Engine to a different IP address (e.g. if you are running Hand Engine and Unity on different computers on the same LAN), use this IP address instead for Host.
-
Press the Connect check box once to make the hand asset in Unity live and slaved to the data stream coming from Hand Engine, and the connected hand will start moving.
NOTE: This check box will clear itself immediately and the connected hand will start moving. -
You can now use the hand controlled by your StretchSense MoCap Pro Glove in your Unity Project.
Disclaimer, Intellectual Property, and Licensing
Revision Summary
Revision |
Date |
Notes |
12 |
2022.11.10 |
Removed outdated Hand Engine pictures. |
11 |
2021.11.01 |
Updated links for HS |
10 |
2021.10.04 |
Updated images for HE 1.4 |