This document is about: FUSION 2
SWITCH TO

Blocking contact

Fusion Industries prototyping Addons

This module extends the hardware grabbing system available in the VRShared sample, to allow surfaces to block some objects with a tip (pen ,...) while also blocking the hand grabbing it.

Contact logic

A BlockableTip component contains a tip, a child transform, determining the actual tip (the blocking "point") of the object position.

The BlockableTip component detects trigger contact with objects having their layer in the blockingLayers mask, and having an BlockingSurface component.

From there, the actual contact with the surface is confirmed in IsInContact by the local coordinates of the tip in the detected surface referential:

  • the BlockingSurface's positiveProximityThresholds and negativeProximityThresholds determine when the contact is effective.
  • x and y value define the size of the surface, while the z value defines accepted depth of contact (the blocking effect will be along the z axis of the surface).
  • the BlockingSurface max depth determines at which z depth the tip (and grabbing hand) should be blocked

Tip and hand blocking

The blocking itself happens in the FixContactPosition() method: the component defines the target z position of the tip, so that the depth constraint is respected.

Then, it determines the actual BlockableTip gameObject position so that the tip finally reaches this target position.

And finally, the hand is moved so that the grabbing initial position is respected.

Dependencies

  • Feedback addon

Demo

A demo scene can be found in Assets\Photon\FusionAddons\BlockingContact\Demo\Scenes\ folder.

The scene contains a surface with a BlockingSurface component and a grabbable pen with a BlockableTip.
Please note that the pen is deliberately not functional in this demo scene.

Download

This addon latest version is included into the Industries addon project

It is also included into the free XR addon project

Supported topologies

  • shared mode

Changelog

  • Version 2.0.4: Add visionOS compatibility with optional VisionOSHelpers add-on's spatial grabbers support
  • Version 2.0.3:
    • Add compatibility for non-grabbable blockable (useful for MX Ink pen)
    • Add useFeedback option
  • Version 2.0.2: Add missing checks
  • Version 2.0.1: Add string based layer mask edition for BlockableTip
  • Version 2.0.0: Fusion 2.0 support
  • Version 1.0.3: Improve demo scene
  • Version 1.0.2: Fix because of feedback namespace modification
  • Version 1.0.1: Add demo scene + add verification in BlockingContact to avoid error if feedback is not defined + add namespace
  • Version 1.0.0: First release
Back to top