VRTK_ObjectControl

Overview

Provides a base that all object control locomotions can inherit from.

Script Usage:

This is an abstract class that is to be inherited to a concrete class that provides object control locomotion functionality, therefore this script should not be directly used.

Inspector Parameters

• Device For Direction: The direction that will be moved in is the direction of this device.
• Disable Other Controls On Active: If this is checked then whenever the axis on the attached controller is being changed, all other object control scripts of the same type on other controllers will be disabled.
• Affect On Falling: If a VRTK_BodyPhysics script is present and this is checked, then the object control will affect the play area whilst it is falling.
• Control Override Object: An optional game object to apply the object control to. If this is blank then the PlayArea will be controlled.
• Controller: The controller to read the controller events from. If this is blank then it will attempt to get a controller events script from the same GameObject.
• Body Physics: An optional Body Physics script to check for potential collisions in the moving direction.

Class Variables

• public enum DirectionDevices - Devices for providing direction.
  • Headset - The headset device.
  • LeftController - The left controller device.
  • RightController - The right controller device.
  • ControlledObject - The controlled object.

Class Events

• XAxisChanged - Emitted when the X Axis Changes.
• YAxisChanged - Emitted when the Y Axis Changes.

Unity Events

Adding the VRTK_ObjectControl_UnityEvents component to VRTK_ObjectControl object allows access to UnityEvents that will react identically to the Class Events.

• All C# delegate events are mapped to a Unity Event with the On prefix. e.g. MyEvent -> OnMyEvent.

Event Payload

• GameObject controlledGameObject - The GameObject that is going to be affected.
• Transform directionDevice - The device that is used for the direction.
• Vector3 axisDirection - The axis that is being affected.
• Vector3 axis - The value of the current touchpad touch point based across the axis direction.
• float deadzone - The value of the deadzone based across the axis direction.
• bool currentlyFalling - Whether the controlled GameObject is currently falling.
• bool modifierActive - Whether the modifier button is pressed.