Get Started

In this section, we will give you a very short introduction to the toolkit by guiding you to get started with a simple test redirection scenario. If you want to create your own redirection scenario or test a new redirection algorithm you will find more help in the Tutorial section. But we recommend you to start with this short and quick introduction.

Requirements

• Unity Version 2019.4 (recommended)
• The HaRT_core package from our github page
• The Unity Steam VR Package and install the Unity Steam VR Modules
• Optional if used with Leap Motion: The Unity Leap Modules (Additional help)

Get Started with Our Test Scene

Import Package

• Create a new Unity project
• Import the HaRT_core Unity package: Asset->Import->CustomPackage -> HaRT_core

Set Up your project

• Since Unity is not able to import layers, create these five new layers in your project:
  
  • Physical/Hand
    
  • Physical/Object
    
  • Virtual/Hand
    
  • Virtual/Object
    
  • Visualization
    

Open the Test Scene

• Go to Plugins/ExampleScenes/ and open the GetStarted.unity
  

• The Scene:
  
  Here you can see a top-down view of the GetStarted scene. In general, white objects present physical objects and green objects the virtuals. Our body is represented as a white sphere. So, in this scenario, we have a physical cube in front of us and a slightly right-shifted virtual cube. We now want to reach with our virtual hand the virtual cube in the virtual world while we reach with our physical hand the physical cube in the real world.

• Make sure that the game view is on Display 1 and hit Play

Redirect!

• You can now move your hand with the mouse while holding the left mouse button

  • Scroll with your mouse wheel while holding the left mouse button to move the hand upwards/downwards

• Hit spacebar to start redirecting to the target

Become Familiar

We recommend you to read over this Wiki to get an understanding of how the different components work together. You can now continue with more Tutorials or try to play with some settings in this scene:

• Most settings can be customized/changed in the [Redirection Manager](Redirection Manager)
• You can add/change virtual and physical objects, see more in [Set Up the World](Set Up the World)
• Or test the current scene with your VR setup, for this, continue reading this page.

Optional Setup

Steam VR

The HaRT_core package includes all important files to run the toolkit with or without VR. To use all example scenes, EITHER place the [CameraRig] prefab from the SteamVR UnityPackage as a child object to the HaRT_core game object OR

• Go to /ExampleScenes/VR and open BlockIllusionExample_VR.unity
• Go to the RedirectionManager and select "VR" as Movement Option
• Hit Play and redirect!

Leap Motion

• Make sure you have finished the Get Started section above successfully
• Download and install the Unity Leap Modules (Additional help)
• Download the HaRT_Leap package from our github page
• Import the hrt_Leap Unity package into your existent Unity project: Asset->Import->CustomPackage -> HaRT_Leap
• Go to /ExampleScenes/ and open the LeapMotionExample.unity
• Go to the RedirectionManager and select Leap as Movement Option
• Hit Play and redirect!