VR Input System

The VR input system allows managing user input from VR controllers, head-mounted displays (HMDs), base stations, and trackers. It supports a wide range of VR devices, enabling you to utilize several devices from various vendors and process input from them.

The InputVRDevice class provides access to properties and settings common for all VR devices (for example, a device name).

Controllers serve as a primary interface for VR input. There are three types of VR controllers: left-hand, right-hand controllers, and a treadmill. You can get the controller's type and check whether it is a hand controller by using the corresponding methods of the InputVRController class.

The VR input system supports a range of controller models compatible with OpenVR, Varjo, and Oculus devices. In this article, we will consider the following models of controllers as examples:

• HTC Vive (compatible with OpenVR and Varjo devices)
• Oculus Touch (compatible only with Oculus HMDs and works via OpenVR)
• Valve Knuckles (compatible with OpenVR and Varjo devices)

UNIGINE API provides access to the VR controller inputs — axes and buttons.

• Buttons are mapped to the controller's buttons that can be pressed, touched, or released.
• Axes detect 1-dimensional movement of the control and have more complex behavior.

  Depending on the type of the VR controller, the number of axes differs. UNIGINE supports up to 4 axes. But usually, a controller has 3.

  In UNIGINE, an axis can be mapped to a control of one of the following types (also referred to as an axis type): trackpad, joystick, or trigger. Each axis type has a different number of reserved axes. For example, combining two axes of a joystick or trackpad allows tracking of 2-dimensional movement along the X and Y axes.

  Notice

  You cannot know in advance which type of controller is connected, so UNIGINE API allows you to identify the number of supported axes and check their types.

OpenVR Controllers#

The VR system allows you to process input from head-mounted displays (HMDs) via the InputVRHead class.

A VR base station helps the HMD and controllers to track their exact positions, enhancing the immersion of room-scale virtual reality experience.

The InputVRDevice and InputVRBaseStation classes is used to handle base station input.

A VR tracker allows embedding real-world objects into the VR environment. You can attach it to a real thing that needs to be tracked. In Mixed Reality, you can install the VR tracker on a camera or player to track its position in the virtual world.

The InputVRDevice and InputVRTracker classes is used to manage tracker input.