Grabbables in Interaction SDK

Grabbable entities in Spatial SDK can be manipulated by a hand or controller. By default, only one device can manipulate them at a time. Add the Grabbable component to an entity to enable grabbing.

To configure some of the grabbing behavior, you can optionally add the IsdkGrabConstraints component to an entity. This component allows you to constrain the transforms or scale of a grabbed object, and lock the object’s position, rotation, and scale attributes.

To enable transform of an entities scale, you will need to enable two-handed transform mode. Don’t enable scale entities that have a Physics component, as the behavior will be unexpected.

Interaction SDK’s IsdkToolkitBridgeSystem automatically adds the grabbable feature to any entity that has both a Grabbable component and either a mesh or collider component. No manual changes are needed to use the feature. However, Interaction SDK’s grabbable feature also provides a direct movement type and tuning values for responsiveness. To access these, manually add the IsdkGrabbable component to an entity.

For the Interaction SDK grab system to detect an object, it must have a Grabbable component and either a Mesh component or a Collider. If both are present, the Collider is used. For improved runtime performance and the ability to use touch-grabs (grabbing an object while your hand or controller is inside it), add collider components instead of relying on mesh component collision. You must use Spatial SDK Collider components, as they are mapped to Interaction SDK’s internal colliders.

This table shows how Spatial SDK colliders map to Interaction SDK’s internal colliders, including the style of grabbing each supports.

If you’ve disabled Interaction SDK’s IsdkToolkitBridgeSystem but want to enable grabbing functionality for an entity, follow these steps.