Installation

Where is the GleechiLib Prefab?

If you see the use of GleechiLib prefab in one of our videos, but can not find it in the SDK: the GleechiLib Prefab was removed in version 0_9_6. You are expected to just insert a VG_MainScript component (such as MyVirtualGrasp) on a GameObject of your choice.

Hands and Controllers

I used the VG_AutoSetup with a controller but the hands don’t move.

Assure that all the requirements of the controller you picked are met. You can find these requirements at the top of each script in ThirdParty/VirtualGrasp/VG_ExternalControllers/VG_EC_***.cs, as well as on the specific documentation pages. Do not forget to uncomment the #define in the script as soon as you have installed all prerequisites.

Does VG support other headsets / controllers?

The VG SDK is hardware-agnostic and does not depend on a headset. Thus, the question of headset support goes more towards Unity. In terms of controllers, VG SDK provides a customizable controller abstraction (see VG_ExternalControllerManager) for a few stand-alone controllers and abstractions (such as UnityXR) which require their Unity SDKs. If your controller is not supported, you can either write a VG_ExternalController for it yourself, or contact us.

I am using my own hand models and the fingers bend strangely.

The reason for the mismatch is that each controller (for example, VG_EC_OculusHands.cs) is adjusting the raw finger orientations that come directly from the controller API (for example, from the Oculus Integration plugin) to match the hand model representation that is provided with the SDK. Read more on ways to resolve this issue on the VG_ExternalControllerManager page.

Interaction

When grasping a fast-moving object, the hand is following the object

The default interaction type for all objects is TRIGGER_GRASP and Grasp Speed 0.1 (see Global Interaction Settings which means that the a grasp moves the hand to the object in 0.1 seconds.

So, when you are trying to catch a fast moving object such as a falling one, the hand will follow the object for 0.1 sec to grab it while falling. There are two quick options to get a different experience:

  1. Decrease the Grasp Speed to 0.01 (which is the minimum). This makes the grasp happen quicker, while still moving the hand to the object.
  2. Change the interaction type to JUMP_GRASP and the object will move towards the hand instead. Note that it will now still take the time of the Grasp Speed for the object to interpolate into the hand. These and more interaction types are documented here.

Note that you cannot define the Grasp Speed for a specific object. You can switch the interaction type for a specific object, either by using a VG_Interactable on your object to change it from the start, or by using the API function VG_Controller.SetInteractionTypeForObject from your code during runtime.

Baking

How am I supposed to import the .obj files (in vg_tmp) into my project?

You are not supposed to import the .obj files in your own scenes (since you have your original models there). The main purpose of the .obj files is to represent the raw mesh data of objects when they shall be sent through the Baking Client to the cloud baking service. You can read more information on Debug Files.

Common Unity Error Messages

“Root actors empty”

[VG] [ObjectSelector] [error] Object keypadbutton0/20174 root actors are empty!

This can be caused by multiple things e.g:

  • Static geometry flag is enabled for object, or
  • Transform scale is 0 (maybe during animation) on the object or any parent in the hierarchy.

Mesh not readable

[12:22:57] The mesh for screwdriver is not readable. Object cannot be processed.

This is because the source of that MeshRenderer have not checked “Read/Write enabled” checkbox in the model inspector. VG has an utility script you could use as shown in below image. Clicking Make interactables readable will check this Read/Write checkbox for all objects that have been marked as interactable.

VG utility make interactables readable
VG Utility: Make interactables readable