VersionAlert for UnityVersionAlert for Unity

com.unity.xr.interaction.toolkit 3.2.0

com.unity.xr.interaction.toolkit

Source docs
Notes: processedReleased July 1, 2025

Browse versions

PreviousNext

Unity Compatibility

Minimum Unity: 2021.3

Package Dependencies

✨ Features

  • Added additional Editor analytics to gather data about locomotion components that helps Unity understand how the package is being used in projects. If you don't want to send data to Unity, please see Editor analytics documentation for how to disable analytics in your project.
  • Added configurable functionality to `ARContactSpawnTrigger` in the AR Starter Assets sample to block spawning of objects on AR Planes when the active interactor in the associated `XRInteractionGroup` is either hovering or selecting an interactable object.
  • Added documentation for [World-Space UI Toolkit support](xref:xri-ui-world-space-ui-toolkit-support) and the [World Space UI sample package](xref:xri-samples-world-space-ui).

📈 Improvements

  • Changed the timing of when several locomotion events and methods are called within a frame. The primary motivation of these changes is to allow the `LocomotionProvider.locomotionEnded` event to invoke after a teleport has actually been applied to the XR Origin rather than after the transformation has merely been queued but not yet applied. This restores similar timing to that event as the deprecated `LocomotionProvider.endLocomotion` when the deprecated `LocomotionSystem` was used, fixing a regression introduced with version [3.0.0-pre.1](#300-pre1---2023-12-14). (XRIT-255)
  • - Added `LocomotionProvider.locomotionStateChanged` event and `OnLocomotionStateChanging` method to allow users to respond to the changing `locomotionState` before any queued transformations have been applied.
  • - Added `LocomotionProvider.afterStepLocomotion` event which is invoked after a provider's queued transformation has been applied.
  • - Added `XRBodyTransformer.afterApplyTransformations` event which is invoked after all transformations have been applied in a frame.
  • - Changed `XRBodyTransformer.beforeApplyTransformations` so it is only invoked during a frame when a transformation is about to be applied rather than always being invoked every frame even if nothing had been queued.
  • - Changed `LocomotionProvider.locomotionEnded` event and `OnLocomotionEnding` method so it is invoked after any of the provider's queued transformations have been applied rather than immediately after changing `locomotionState` to `LocomotionState.Ended`.
  • - Changed `LocomotionProvider` so the `OnLocomotionEnding` method is invoked before the `locomotionEnded` event, matching the pattern elsewhere in the package of the `protected virtual` method being invoked before the `public` event.
  • - Fixed `LocomotionProvider.beforeStepLocomotion` so it is invoked as expected when a locomotion component (such as Snap Turn Provider) has a Delay Time.
  • - Fixed XR Grab Interactable being thrown at very high velocities after a teleportation due to the change in `LocomotionProvider.locomotionEnded` event timing.
  • Changed the Transformation Priority value on some Locomotion Provider components in the XR Origin (XR Rig) prefab in the Starter Assets sample to improve the default ordering when multiple providers are doing locomotion in the same frame.
  • - Changed Gravity Provider from 0 to 10 to make it more apparent that its transformations are applied after non-teleport locomotion. Due to script execution order, this was already the case.
  • - Changed Teleportation Provider from 0 to 20 so that its transformations are applied last among all the providers in the rig. This is to allow the rig to move and rotate to the exact pose previewed by the teleport reticle. Due to script execution order, it was previously indeterminate if it applied before or after move/turn locomotion.
  • Changed XR Grab Interactable so snap turn and turn around are handled the same as a teleportation when calculating the throw velocity. This fixes the object being thrown at unintentionally high velocity when dropped immediately after a snap turn or turn around.
  • Changed XR Grab Interactable so it also updates the Predicted Visuals Transform scale between phy