Work in progress
Godot documentation is being updated to reflect the latest changes in version
4.0. Some documentation pages may
still state outdated information. This banner will tell you if you're reading one of such pages.
The contents of this page are up to date. If you can still find outdated information, please open an issue.
Inherits: RefCounted < Object
A tracked object.
An instance of this object represents a device that is tracked, such as a controller or anchor point. HMDs aren't represented here as they are handled internally.
As controllers are turned on and the XRInterface detects them, instances of this object are automatically added to this list of active tracking objects accessible through the XRServer.
The XRController3D and XRAnchor3D both consume objects of this type and should be used in your project. The positional trackers are just under-the-hood objects that make this all work. These are mostly exposed so that GDExtension-based interfaces can interact with them.
get_input ( StringName name ) const
get_pose ( StringName name ) const
has_pose ( StringName name ) const
invalidate_pose ( StringName name )
set_input ( StringName name, Variant value )
set_pose ( StringName name, Transform3D transform, Vector3 linear_velocity, Vector3 angular_velocity, TrackingConfidence tracking_confidence )
Emitted when a button on this tracker is pressed. Note that many XR runtimes allow other inputs to be mapped to buttons.
Emitted when a button on this tracker is released.
input_float_changed ( String name, float value )
Emitted when a trigger or similar input on this tracker changes value.
input_vector2_changed ( String name, Vector2 vector )
Emitted when a thumbstick or thumbpad on this tracker moves.
pose_changed ( XRPose pose )
Emitted when the state of a pose tracked by this tracker changes.
profile_changed ( String role )
Emitted when the profile of our tracker changes.
TrackerHand TRACKER_HAND_UNKNOWN =
The hand this tracker is held in is unknown or not applicable.
TrackerHand TRACKER_HAND_LEFT =
This tracker is the left hand controller.
TrackerHand TRACKER_HAND_RIGHT =
This tracker is the right hand controller.
String description =
The description of this tracker.
TrackerHand hand =
void set_tracker_hand ( TrackerHand value )
TrackerHand get_tracker_hand ( )
Defines which hand this tracker relates to.
StringName name =
void set_tracker_name ( StringName value )
StringName get_tracker_name ( )
The unique name of this tracker. The trackers that are available differ between various XR runtimes and can often be configured by the user. Godot maintains a number of reserved names that it expects the XRInterface to implement if applicable:
left_handidentifies the controller held in the players left hand
right_handidentifies the controller held in the players right hand
String profile =
The profile associated with this tracker, interface dependent but will indicate the type of controller being tracked.
TrackerType type =
void set_tracker_type ( TrackerType value )
TrackerType get_tracker_type ( )
The type of tracker.
Variant get_input ( StringName name ) const
Returns an input for this tracker. It can return a boolean, float or Vector2 value depending on whether the input is a button, trigger or thumbstick/thumbpad.
XRPose get_pose ( StringName name ) const
Returns the current XRPose state object for the bound
bool has_pose ( StringName name ) const
true if the tracker is available and is currently tracking the bound
void invalidate_pose ( StringName name )
Marks this pose as invalid, we don't clear the last reported state but it allows users to decide if trackers need to be hidden if we loose tracking or just remain at their last known position.
void set_input ( StringName name, Variant value )
Changes the value for the given input. This method is called by a XRInterface implementation and should not be used directly.
void set_pose ( StringName name, Transform3D transform, Vector3 linear_velocity, Vector3 angular_velocity, TrackingConfidence tracking_confidence )
Sets the transform, linear velocity, angular velocity and tracking confidence for the given pose. This method is called by a XRInterface implementation and should not be used directly.