Skip to main content

Interface: DwellConfig

Defined in: webxr-interactions/src/gaze.ts:15

Gaze support - first-class, per the design decision that gaze serves two roles:

  1. Combination gating (gaze.required): input on an interactable only counts while the viewer is looking at it.
  2. Accessibility (gaze.dwell): looking at an interactable fills a dwell meter; a full meter fires a synthesized press - no hands needed. Consumers render the meter from dwellProgress events.

The dwell state machine is pure and headless-tested. The runtime feeds it hover booleans; it never sees the engine.

Properties

PropertyTypeDescriptionDefined in
decayFactor?numberDrain speed multiplier when looking away.webxr-interactions/src/gaze.ts:19
holdSeconds?numberSeconds of sustained gaze to fire.webxr-interactions/src/gaze.ts:17
rearmBelow?numberAfter firing, progress must fall below this before it can re-arm.webxr-interactions/src/gaze.ts:21