AR Raycast component

The ARRaycast component is a type of trackable that contains the data associated with a tracked ray cast. Tracked ray casts continuously project a ray from a two-dimensional pixel position on the screen (a screen point).

AR Raycast component

Property	Description
Destroy On Removal	If true, this component's GameObject is destroyed when this trackable is removed.

Raycast lifecycle

As trackables, AR ray casts have a lifecycle that consists of three phases: added, updated, and removed. Your app can respond to Raycast lifecycle events during an AR session if you subscribe to the AR Raycast Manager component's trackablesChanged event.

Added

When you create a tracked ray cast, it has the added phase.

Updated

Each subsequent frame after a tracked ray cast is added, the AR Raycast Manager might update that ray cast's information. There are two events invoked in each frame for which a tracked ray cast is updated, as described in the following table:

Event	Description
ARRaycast.updated	Invoked whenever this raycast is updated. The event is fired during this MonoBehaviour's Update callback. This event is not invoked if this component is disabled, although it might continue to receive positional updates.
ARRaycastManager.trackablesChanged	This method contains a list of all changed ray casts in the frame.

Tracking state

A trackingState value of Limited indicates that a tracked ray cast is not tracking normally, and its distance may be less accurately estimated than when the ray cast is in the Tracking state.

Removed

You can remove tracked ray casts manually with the RemoveRaycast method. Refer to Remove a ray cast to understand how to remove a ray cast manually.