Skip to content

Get Started

Hannah edited this page Apr 18, 2021 · 30 revisions

In this section, we will give you a very short introduction into 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.

Get Started with Our Test Scene

Import Package

  • Download the HaRT_core package from our github page
  • Create a new Unity project (2019.4 recommended)
  • 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

Layer Setup

Open the Test Scene

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

  • The Scene:
    Screenshots
    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

Import Package

Leap Motion

Import Package

  • Download and install the Unity Leap Modules (Additional help)
  • For our toolkit, the leap core package is enough
  • Download the HaRT_leap package from our github page
  • Import the hrt_leap Unity package: Asset->Import->CustomPackage -> HaRT_leap