What's new in version 3.0

Summary of changes in XR Interaction Toolkit package version 3.0:

Added

Input Readers

The biggest change in XRI 3.0 comes in the form of a new Input Reader architecture. The input readers allow a simplified, yet more sophisticated abstraction of input. Within this new architecture, it is possible to use legacy input, actions from the Input System package, manual manipulation (in Editor or via APIs), or custom scriptable objects for special cases or custom hardware platforms. Due to these changes, it became possible to simplify the input in such a way that the divergence in the old XRBaseController was no longer required and input could be embedded directly into the interactors, lowering code complexity and decreasing component count across GameObjects. To find out more about the new input readers, check out the Demo Scene in the Starter Assets. If you need to continue to use legacy input, there is a set of Legacy Input Readers in the included sample packages as well.

Note

Due to the nature of the changes introduced by the input readers, you may notice rolling changes to many of the other components throughout the XR Interaction Toolkit that reflect the usage of these new classes. You will likely want to upgrade your own project if you use Input Actions on any of your custom components.

XR Body Transformers and Locomotion Mediator

A new way to move and manipulate the XR Origin in response to input and interactions has been added. XR Body Transformers allow specific types of manipulation of the XR Origin and can be queued up for processing by the new LocomotionMediator. The original locomotion provider classes have been updated to use the new XR body transformations, simplifying the code and allowing for greater flexibility when extending the locomotion system as a whole. Along with the input changes, the original locomotion provider classes have also been updated or replaced to take full advantage of the new input architecture, streamlining the way locomotion is handled across the board. Read more about this in the Locomotion documentation.

Climb teleportation

On top of the locomotion mediator changes, climbing and teleportation has been enhanced to provide teleportation up and down ladders. In addition to simple endpoint-to-endpoint teleportation, Teleportation multi-anchor volumes have been added. These allow multiple predefined teleport outlets per climbing surface which can be selected based on head or eye gaze (or any other method of determination). For more information about these new additions, please read the Locomotion documentation and check out an example of how these updates are used in the Demo Scene of the Starter Assets sample package.

Deprecations

Controller-based classes

With the new input changes outlined above, the controller-based classes are now obsolete and have been deprecated to reflect this. The functionality of the controller classes can be found in a combination of the standard TrackedPoseDriver as well the input properties on the individual interactors where that input makes sense.

AR interactables and gesture interactor

With the introduction of ARTransformer, ScreenSpaceRayInteractor, and the associated input components for screen space interaction, the individual AR interactable classes and the ARGestureInteractor have been deprecated.

Locomotion system and controller-based providers

The LocomotionSystem has been deprecated and replaced by the LocomotionMediator component. Along with this, and due to the input changes outlined above, the locomotion providers that depended on the previous input handling architecture have been deprecated and replaced with a simplified streamlined variant of each.

Affordance system

The affordance system has also been deprecated in XRI 3.0. A new feedback system to handle visuals, audio, haptics and more will be coming soon in a future release of XRI.

For a full list of changes and updates in this version, see the XR Interaction Toolkit package changelog.