docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

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

    In This Article
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)