Table of Contents

Update
Trigger/Collision and Enter/Exit
Grab and Use

Condition and timing of event function calls

Update

update()

The owner of VCI
Every frame

Remarks

The owner of VCI and the owner of SubItem are different
[Public studio only] The owner of the VCI is the first joiner to the room
[Public studio only] When the owner of the VCI leaves the room, the ownership will be transferred to another user (in order of room join)

updateAll()

All users
Frames

Trigger/Collision and Enter/Exit

onTriggerEnter(item, hit)

Owner of SubItem
When Trigger collides

Remarks

A SubItem without ownership will have its Rigidbody turned to Kinematic=true
- For the difference in the firing of Trigger events with Kinematic=true/false, refer to Collision action matrix from the link below
- https://docs.unity3d.com/2018.3/Documentation/Manual/CollidersOverview.html
The Collider has isTrigger true (SubItem itself doesn't have to have Rigidbody)

onTriggerExit(item, hit)

Owner of SubItem
When Trigger was disengaged

Remarks

SubItem without the ownership will have its Rigidbody turned to Kinematic=true
- For the difference in the firing of Trigger events with Kinematic=true/false, refer to Collision action matrix from the link below
- https://docs.unity3d.com/2018.3/Documentation/Manual/CollidersOverview.html
The Collider has isTrigger true (SubItem itself doesn't have to have Rigidbody)

onCollisionEnter(item, hit)

Owner of SubItem
When Collier collides

Remarks

A SubItem without ownership will have its Rigidbody turned to Kinematic=true
- For the difference in the firing of Trigger events with Kinematic=true/false, refer to Collision action matrix from the link below
- https://docs.unity3d.com/2018.3/Documentation/Manual/CollidersOverview.html
isTrigger for the Collider is false + The SubItem have to have Rigidbody

onCollisionExit(item, hit)

Owner of SubItem
When collision was disengaged

Remarks

A SubItem without ownership will have its Rigidbody turned to Kinematic=true
- For the difference in the firing of Trigger events with Kinematic=true/false, refer to Collision action matrix from the link below
- https://docs.unity3d.com/2018.3/Documentation/Manual/CollidersOverview.html
isTrigger for the Collider is false + The SubItem have to have Rigidbody

Grab and Use

In Virtual Cast, an action of grabbing is used as a trigger to transfer an ownership

This means the following states could occur:

Grabbing
Not having ownership (Other user grabbed the item you own. Requesting the ownership)
The grab event doesn't happen

Grabbing
Not having ownership (Ownership of the item you are grabbing has been transferred to another user who grabbed the item)
The ungrab event that is supposed to happen after this does not happen.

To counter this, Virtual Cast judges the conditions for Grab and Use events as shown below.

onGrab(target)

Owner of SubItem
Have ownership before grabbing
- When grabbed
Received ownership after grabbing
- When received ownership

Remarks

The event might fire a few moments later after being grabbed

onUngrab(target)

When ungrabbed
Or when lost ownership (Won't have ownership during the script run)

Remarks

The event might fire when you lost the ownership, even while you are holding the item

onUse(use)

Owner of SubItem
When you pressed the Use button

onUnuse(use)

When you released the Use button
Or when lost ownership (Won't have ownership during the script run)

Remarks

The event could fire when you lost the ownership even while you are holding the button