Locomotion Providers overview
Locomotion Providers implement different types of locomotion.
The toolkit supplies multiple Locomotion Providers, which implement the LocomotionProvider abstract class.
Locomotion Providers contain a reference to Locomotion Mediator, which gives the Locomotion Provider access to the XR Body Transformer. If the Locomotion Mediator is null, the Locomotion Provider will attempt to find one.
Once the Locomotion Provider has calculated the transformation, the provider is ready to begin locomotion.
Use TryPrepareLocomotion to communicate with the Locomotion Mediator and attempt to transition the provider into the LocomotionState.Preparing state. If this succeeds, then the provider can enter the LocomotionState.Moving by waiting for the mediator's next Update in which the provider's canStartMoving is true. This will provide the Locomotion Provider with access to the XR Body Transformer.
Alternatively, use TryStartLocomotionImmediately to attempt to transition the provider into the LocomotionState.Moving state and to gain access to the required XR Body Transformer immediately. Note, TryStartLocomotionImmediately will bypass LocomotionState.Preparing state and the LocomotionProvider.canStartMoving check.
When the Locomotion Provider receives to the XR Body Transformer, the provider can try to queue the desired transformation with the XR Body Transformer. See XR Body Transformer for a more thorough explanation of the queueing process.
Upon completion of the locomotion, use TryEndLocomotion to have the Locomotion Mediator attempt to transition the Locomotion Provider to the LocomotionState.Ended. The Locomotion Mediator will call LocomotionProvider.OnLocomotionEnd().
The LocomotionProvider abstract class also providers two events:
locomotionStartedis invoked once the provider successfully enters theLocomotionState.Movingstate.locomotionEndedis invoked once the provider successfully enters theLocomotionState.Endedstate.