VRTK_HeadsetCollision

Overview

The purpose of the Headset Collision is to detect when the user's VR headset collides with another game object.

The Headset Collision script will automatically create a script on the headset to deal with the collision events.

Inspector Parameters

• 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.

• OnHeadsetCollisionDetect - Emits the HeadsetCollisionDetect class event.
• OnHeadsetCollisionEnded - Emits the HeadsetCollisionEnded class event.

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.

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.