specs-interaction-recipes

Create an Interactable component from SpectaclesInteractionKit on your scene object and subscribe to onTriggerStart inside an OnStartEvent binding. The TapInteraction recipe wraps this pattern with named onTap, onHoverStart, and onHoverEnd hooks and auto-creates a collider.

SIK Interactable, InteractableManipulation, HandInputData pinch, and GestureModule events must be subscribed inside createEvent("OnStartEvent"), not directly in onAwake. SIK wires its events during its own onAwake, so binding earlier races that initialization.

Interactable-based interactions work automatically via SIK's MouseInteractor. Gestures built on raw HandInputData or GestureModule events need a manual mock binding TouchStartEvent, TouchMoveEvent, and TouchEndEvent, with Shift switching vertical drag between Y and Z axes.

Double-firing happens when you bind TapEvent or TouchStartEvent on top of an Interactable. SIK's MouseInteractor already routes editor clicks into Interactable.onTriggerStart, so the manual binding fires the same callback a second time.

Use GestureModule getGrabBeginEvent for full-fist grabs on chunky objects like levers or handles, where grabbing feels more natural. SIK pinch via Interactable suits small or precise targets and gives automatic editor support through MouseInteractor.

Track wrist position in camera-local space between pinch-down and pinch-up, then classify the dominant axis with a cone-of-acceptance strictness factor of 1.3. The SwipeInteraction recipe implements this with a 5 cm threshold and 0.75 second duration cap.