Requirements:

  • a Windows computer,
  • a Unity3D installation (latest recommended),
  • [optional] an Oculus Quest headset.

Installing the Unity Engine plugin

If you start from scratch, just create a new, empty project in Unity. It is recommended to always use the most recent Unity version in terms of major version number (e.g., 2020.x.x, 2021.x.x, etc). Unity and the VirtualGrasp SDK are very robust in terms of up- or downgrading inside a major version for your projects.

New Unity Project
Create a New Project in Unity

To import VirtualGrasp into your Unity project, go to Assets → Import Package → Custom Package and import the VirtualGrasp *.unitypackage. After doing this, you should find the main VirtualGrasp installation under ThirdParty/VirtualGrasp in your Unity project.

Getting Started with VirtualGrasp and the Console View

There is only one minimal main component you have to add by default to use and configure VirtualGrasp: MyVirtualGrasp.cs. Adding a component to your scene and playing your scene, you should see some messages produced by the plugin in the Console Window.

You can identify that VG has been successfully initialized when a message like these appear on the Console, also informing you of the SDK version:

Initialized VirtualGrasp SDK 0.10.1 (core 0.6.6).

QuickStart Video

QuickStart with VirtualGrasp in Unity.