XR Ray Interactor

Interactor used for interacting with Interactables at a distance. This is handled via ray casts that update the current set of valid targets for this interactor.

Property	Description
Interaction Manager	The XRInteractionManager that this Interactor will communicate with (will find one if None).
Interaction Layer Mask	Allows interaction with Interactables whose Interaction Layer Mask overlaps with any Layer in this Interaction Layer Mask.
Handedness	Represents which hand or controller the interactor is associated with.
UI Interaction	Enable to affect Unity UI GameObjects in a way that is similar to a mouse pointer. Requires the XR UI Input Module on the Event System.
Block Interactions With Screen Space UI	Enable this to make the XR Ray Interactor ignore interactions when occluded by a screen space canvas.
Block UI on Interactable Selection	Enabling this option will block UI interaction when selecting interactables.
Force Grab	Force grab moves the object to your hand rather than interacting with it at a distance.
Manipulate Attach Transform	Allows the user to move the Attach Transform using the thumbstick.
Translate Speed	Speed that the Attach Transform is translated along the ray. Only used and displayed when Manipulate Attach Transform is enabled.
Rotate Reference Frame	The optional reference frame to define the up axis when rotating the Attach Transform. When not set, rotates about the local up axis of the attach transform. Only used and displayed when Manipulate Attach Transform is enabled.
Rotate Mode	Specifies how the Attach Transform rotation manipulation is controlled. Only used and displayed when Manipulate Attach Transform is enabled.
Rotate Over Time	Set Rotation Mode to Rotate Over Time to control attach rotation over time while rotation input is active.
Match Direction	Set Rotation Mode to Match Direction to match the attach rotation to the direction of the 2-dimensional rotation input.
Rotate Speed	Speed that the Attach Transform is rotated. Only used and displayed when Manipulate Attach Transform is enabled and Rotation Mode is set to Rotate Over Time.
Scale Mode	Determines how the Scale Value should be used by the interactable objects requesting it.
Attach Transform	The Transform that is used as the attach point for Interactables. Automatically instantiated and set in Awake if None. Setting this will not automatically destroy the previous object.
Ray Origin Transform	The starting position and direction of any ray casts. Automatically instantiated and set in Awake if None and initialized with the pose of the XRBaseInteractor.attachTransform. Setting this will not automatically destroy the previous object.
Disable Visuals When Blocked In Group	Whether to disable visuals when this Interactor is part of an Interaction Group and is incapable of interacting due to active interaction by another Interactor in the Group.
Line Type	The type of ray cast.
Straight Line	Set Line Type to Straight Line to perform a single ray cast into the scene with a set ray length.
Projectile Curve	Set Line Type to Projectile Curve to sample the trajectory of a projectile to generate a projectile curve.
Bezier Curve	Set Line Type to Bezier Curve to use a control point and an end point to create a quadratic Bezier curve.
Max Raycast Distance	Only used and displayed if Line Type is Straight Line. Increasing this value will make the line reach further.
Reference Frame	Only used and displayed if Line Type is either Projectile Curve or Bezier Curve. The reference frame of the curve to define the ground plane and up. If not set at startup it will try to find the XROrigin.Origin GameObject, and if that does not exist it will use global up and origin by default.
Velocity	Only used and displayed if Line Type is Projectile Curve. Initial velocity of the projectile. Increasing this value will make the curve reach further.
Acceleration	Only used and displayed if Line Type is Projectile Curve. Gravity of the projectile in the reference frame.
Additional Ground Height	Only used and displayed if Line Type is Projectile Curve. Additional height below ground level that the projectile will continue to. Increasing this value will make the end point drop lower in height.
Additional Flight Time	Only used and displayed if Line Type is Projectile Curve. Additional flight time after the projectile lands at the adjusted ground level. Increasing this value will make the end point drop lower in height.
Sample Frequency	Only used and displayed if Line Type is Projectile Curve or Bezier Curve. The number of sample points Unity uses to approximate curved paths. Larger values produce a better quality approximate at the cost of reduced performance due to the number of ray casts. A value of n will result in n - 1 line segments for ray casting. This property is not used when using a Line Type of Straight Line since the effective value would always be 2.
End Point Distance	Only used and displayed if Line Type is Bezier Curve. Increase this value distance to make the end of the curve further from the start point.
End Point Height	Only used and displayed if Line Type is Bezier Curve. Decrease this value to make the end of the curve drop lower relative to the start point.
Control Point Distance	Only used and displayed if Line Type is Bezier Curve. Increase this value to make the peak of the curve further from the start point.
Control Point Height	Only used and displayed if Line Type is Bezier Curve. Increase this value to make the peak of the curve higher relative to the start point.
Raycast Mask	The layer mask used for limiting ray cast targets.
Raycast Trigger Interaction	The type of interaction with trigger colliders via ray cast.
Raycast Snap Volume Interaction	Whether ray cast should include or ignore hits on trigger colliders that are snap volume colliders, even if the ray cast is set to ignore triggers. If you are not using gaze assistance or XR Interactable Snap Volume components, you should set this property to Ignore to avoid the performance cost.
Hit Detection Type	Which type of hit detection to use for the ray cast.
Raycast	Set Hit Detection Type to Raycast to use Physics Raycast to detect collisions.
Sphere Cast	Set Hit Detection Type to Sphere Cast to use Physics Sphere Cast to detect collisions.
Cone Cast	Set Hit Detection Type to Cone Cast to use cone casting to detect collisions.
Hit Closest Only	Whether Unity considers only the closest Interactable as a valid target for interaction. Enable this to make only the closest Interactable receive hover events. Otherwise, all hit Interactables will be considered valid and this Interactor will multi-hover.
Blend Visual Line Points	Blend the line sample points Unity uses for ray casting with the current pose of the controller. Use this to make the line visual stay connected with the controller instead of lagging behind. When the controller is configured to sample tracking input directly before rendering to reduce input latency, the controller may be in a new position or rotation relative to the starting point of the sample curve used for ray casting. A value of false will make the line visual stay at a fixed reference frame rather than bending or curving towards the end of the ray cast line.
Select Action Trigger	Choose how Unity interprets the select input action from the controller. Controls between different input styles for determining if this Interactor can select, such as whether the button is currently pressed or just toggles the active state. When this is set to State and multiple interactors select an interactable set to InteractableSelectMode.Single, you may experience undesired behavior where the selection of the interactable is passed back and forth between the interactors each frame. This can also cause the select interaction events to fire each frame. This can be resolved by setting this to State Change which is the default and recommended option.
State	Unity will consider the input active while the button is pressed. A user can hold the button before the interaction is possible and still trigger the interaction when it is possible.
State Change	Unity will consider the input active only on the frame the button is pressed, and if successful remain engaged until the input is released. A user must press the button while the interaction is possible to trigger the interaction. They will not trigger the interaction if they started pressing the button before the interaction was possible.
Toggle	The interaction starts on the frame the input is pressed and remains engaged until the second time the input is pressed.
Sticky	The interaction starts on the frame the input is pressed and remains engaged until the second time the input is released.
Keep Selected Target Valid	Whether to keep selecting an Interactable after initially selecting it even when it is no longer a valid target. Enable to make the XRInteractionManager retain the selection even if the Interactable is not contained within the list of valid targets. Disable to make the Interaction Manager clear the selection if it isn't within the list of valid targets. A common use for disabling this is for Ray Interactors used for teleportation to make the teleportation Interactable no longer selected when not currently pointing at it.
Hide Controller On Select	Controls whether this Interactor should hide the controller model on selection.
Allow Hovered Activate	Controls whether to send activate and deactivate events to interactables that this interactor is hovered over but not selected when there is no current selection. By default, the interactor will only send activate and deactivate events to interactables that it's selected.
Target Track Mode	Specifies how many Interactables that should be tracked in the Targets For Selection property, useful for custom feedback. The options are in order of best performance.
Hover To Select	Enable to have Interactor automatically select an Interactable after hovering over it for a period of time. Will also select UI if UI Interaction is also enabled.
Hover Time To Select	Number of seconds an Interactor must hover over an Interactable to select it.
Auto Deselect	Enable to have Interactor automatically deselect an Interactable after selecting it for a period of time.
Time To Auto Deselect	Number of seconds an Interactor must select an Interactable before it is automatically deselected when Auto Deselect is true.
Starting Selected Interactable	The Interactable that this Interactor automatically selects at startup (optional, may be None).
Audio Events	These tie into the same selection and hover events as the Interactor Events further below - these audio events provide a convenient way to play specified audio clips for any of those events you want.
On Select Entered	If enabled, the Unity editor will display UI for supplying the audio clip to play when this Interactor begins selecting an Interactable.
On Select Exited	If enabled, the Unity editor will display UI for supplying the audio clip to play when this Interactor successfully exits selection of an Interactable.
On Select Canceled	If enabled, the Unity editor will display UI for supplying the audio clip to play when this Interactor cancels selection of an Interactable.
On Hover Entered	If enabled, the Unity editor will display UI for supplying the audio clip to play when this Interactor begins hovering over an Interactable.
On Hover Exited	If enabled, the Unity editor will display UI for supplying the audio clip to play when this Interactor successfully ends hovering over an Interactable.
On Hover Canceled	If enabled, the Unity editor will display UI for supplying the audio clip to play when this Interactor cancels hovering over an Interactable.
Allow Hover Audio While Selecting	Whether to allow playing audio from hover events if the hovered Interactable is currently selected by this Interactor. This is enabled by default.
Haptic Events	These tie into the same selection and hover events as the Interactor Events further below - these haptic events provide a convenient way to provide haptic feedback for any of those events you want.
On Select Entered	If enabled, the Unity editor will display UI for supplying the duration (in seconds) and intensity (normalized) to play in haptic feedback when this Interactor begins selecting an Interactable.
On Select Exited	If enabled, the Unity editor will display UI for supplying the duration (in seconds) and intensity (normalized) to play in haptic feedback when this Interactor successfully exits selection of an Interactable.
On Select Canceled	If enabled, the Unity editor will display UI for supplying the duration (in seconds) and intensity (normalized) to play in haptic feedback when this Interactor cancels selection of an Interactable.
On Hover Entered	If enabled, the Unity editor will display UI for supplying the duration (in seconds) and intensity (normalized) to play in haptic feedback when this Interactor begins hovering over an Interactable.
On Hover Exited	If enabled, the Unity editor will display UI for supplying the duration (in seconds) and intensity (normalized) to play in haptic feedback when this Interactor successfully ends hovering over an Interactable.
On Hover Canceled	If enabled, the Unity editor will display UI for supplying the duration (in seconds) and intensity (normalized) to play in haptic feedback when this Interactor cancels hovering over an Interactable.
Allow Hover Haptics While Selecting	Whether to allow playing haptics from hover events if the hovered Interactable is currently selected by this Interactor. This is enabled by default.
Interactor Events	See the Interactor Events page.

Supporting XR Interactable Snap Volume

For an XR Ray Interactor to snap to an XR Interactable Snap Volume, the ray interactor must be properly configured. The Raycast Snap Volume Interaction property of the XR Ray Interactor must be set to Collide. Additionally, the XR Ray Interactor GameObject must have an XR Interactor Line Visual component with the Snap Endpoint If Available property enabled.