Guides
Guides

VRTK_HeadsetCollision

Overview

Denotes when the HMD is colliding with valid geometry.

Script Usage:

  • Place the VRTK_HeadsetCollision script on any active scene GameObject.

Inspector Parameters

  • Ignore Trigger Colliders: If this is checked then the headset collision will ignore colliders set to Is Trigger = true.
  • Collider Radius: The radius of the auto generated sphere collider for detecting collisions on the headset.
  • Target List Policy: A specified VRTK_PolicyList to use to determine whether any objects will be acted upon by the Headset Collision.

Class Variables

  • public bool headsetColliding - Determines if the headset is currently colliding with another object. Default: false
  • public Collider collidingWith - Stores the collider of what the headset is colliding with. Default: null

Class Events

  • HeadsetCollisionDetect - Emitted when the user's headset collides with another game object.
  • HeadsetCollisionEnded - Emitted when the user's headset stops colliding with a game object.

Unity Events

Adding the VRTK_HeadsetCollision_UnityEvents component to VRTK_HeadsetCollision 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

  • Collider collider - The Collider of the game object the headset has collided with.
  • Transform currentTransform - The current Transform of the object that the Headset Collision Fade script is attached to (Camera).

Class Methods

IsColliding/0

public virtual bool IsColliding()

  • Parameters
    • none
  • Returns
    • bool - Returns true if the headset is currently colliding with a valid game object.

The IsColliding method is used to determine if the headset is currently colliding with a valid game object and returns true if it is and false if it is not colliding with anything or an invalid game object.

GetHeadsetColliderContainer/0

public virtual GameObject GetHeadsetColliderContainer()

  • Parameters
    • none
  • Returns
    • GameObject - The auto generated headset collider GameObject.

The GetHeadsetColliderContainer method returns the auto generated GameObject that contains the headset collider.

Example

VRTK/Examples/011_Camera_HeadSetCollisionFading has collidable walls around the play area and if the user puts their head into any of the walls then the headset will fade to black.