XRShared Overview

The XRShared addon provides the base components to create a XR experience compatible with Fusion. Most other Fusion XR addons rely on it.

Rig architecture

How a user is represented and synchronized, and what the other addons expect from a rig, is described on the Rig Architecture page.

Purpose

The XRShared core addon provides a starting point for other XR addons.

It serves 5 purposes:

  • Define a common architecture for networked XR applications,
  • Provide a common framework for defining what a XR rig is and, to a lesser extent, what XR interactions are,
  • Allow an XR/interaction stack to easily be packaged for this framework,
  • Allow other addons to rely on the common definitions, and so to be compatible with a rig/interaction stack packaged for it,
  • Provide a simple reference rig, and some basic interaction, to provide a reference implementation as well that a quickstart.

XRShared Pages

Page Content
Rig Architecture Hardware and network rigs, rig parts, extrapolation for the local user, interactions, interfaces to implement for a custom rig.
XRHands Synchronization Hand and finger tracking with the XR Hands package, and compression of the hand bones data.

Download

XRShared is included in the XR addons project: see the Download page.

Changelog

  • Version 2.1.14:

    • Add world grabbing locomotion
    • Add named action manager to easily trigger centralized actions from anywhere
    • Add TogglePassthrough to easily toggle between VR and MR
    • Add alternative URP only shader for Fader (for passthrough cases compatibility), as well as optional explicit material provisioning
    • Add option to configure grabbing collider layer in GrabbingSetup
    • Add WristMarker to hand prefabs
    • Add FingerBeamer for finger based teleportation
    • Add move/rotation limit on SelfLocomotionGrabbable
    • Fix issue on TouchableButton if shouldUpdateMaterial is true but no material is
    • Add PopupMessageHandler for basic popup message display (for instance in front of the hardware rig)
    • Split XRAddonsDependencyManager to have acces to the reusable PackageDependencyManager
  • Version 2.1.13:

    • Add ObjectTip to track object ends (for pens, ...)
    • Allow to change during runtime NetworkRigPart.hideRenderersForStateAuthority
  • Version 2.1.12:

    • Add IWrist to define wrist position in a rig
    • Add AddObjectContentToAdapt/RemoveObjectContentToAdapt to RigPartVisualizer to handle at runtime a new game object in its hierarchy
    • Add ITouchableListener/IRegisterableTouchable support to TouchableButton, to send touch event through this interface instead of only through events
  • Version 2.1.11:

    • Add new PermissionsRequester/PermissionWaiter permission system, to ensure that permission are not requested at the same time on Android
    • Changes for Unity 6.3 Compatibility
    • Fix on Grabbable.pauseGrabbability usage to work in a network context
    • Add non networked visibility group handling in Visibility class
    • Add TouchingSetup to add Toucher automatically to an hardware rig
    • Add SimulatedHandSetup to add simulated hand to controllers in an hardware rig
  • Version 2.1.10:

    • Add DisableForDesktop
    • Add new icon in shared design
  • Version 2.1.9:

    • Fix bug in XRHandCollectableSkeletonDriverHelper when searching for the root transform
    • Add helper method to TransformManipulation to compute position offset without scale
    • Add OrientedBounds to compute a bounds with an orientation
    • UI interaction: fix toogle prefab (enable raycast target on images)
  • Version 2.1.8:

    • add automatic locomotion setup options on RigLocomotion
    • fix typo in IFeedbackHandler
  • Version 2.1.7:

    • add verification on HideForLocalUser
    • add material
  • Version 2.1.6:

    • Compatibility with Fusion 2.1
    • Fix for AsyncTask on WebGL
    • Allow for other kind of rig part position modifiers (grabbed objects, ...)
    • Add AuthorityVisualization to debug state authority visualy with a material
    • Add physics grabbable and authority transfer on collision for 2.1 forecast physics
    • Add new UI prefabs
  • Version 2.1.5: Add canvasesToIgnore option to RigPartVisualizer

  • Version 2.1.4: Add IColocalizationRoomProvider to add interoperability between addons in colocalization scenario

  • Version 2.1.3: Various assembly tooling fixes, to handle edge cases (first install, ...)

  • Version 2.1.2: Improve Fader shader presence in builds detection and warning message

  • Version 2.1.1:

    • Add way to position automaticaly transforms to match wrist and index positions
    • Add method in LocalInputTracker to check if a button is pressed no matter on which controller
    • Fix to handle properly hardware rig detection when the build scene list is not properly configured
    • Allow RigPartVisualizer to adapt game objects active status alongside changing renderers visibility
    • Add RayPointer and NetworkedRayPointer to provide synchronized rays
  • Version 2.1.0:

    • Add new locomotion system by grabbing the world
    • Add new DetermineNewRigPositionToMovePositionToTargetPosition() method to TransformManipulation class
    • Add some utility classes (NetworkVisibilty, RingHistory, DebugTools)
    • Grabbable : add pauseGrabbabilty option
    • Update & improve the automatic weaving of XR addons
    • Fix TouchableButton status not reinitialized OnDisable()
    • bug fixes to UI interaction (XSCInputModule)
  • Version 2.0.1: Add shared design & UI prefabs

  • Version 2.0.0: First release

Last updated on

Back to top