XRInputSource: hand property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The read-only hand property of the XRInputSource interface is a XRHand object providing access to a hand-tracking device.

Value

An XRHand object or null if the XRSession has not been requested with the hand-tracking feature descriptor.

Examples

js

navigator.xr
  .requestSession({ optionalFeatures: ["hand-tracking"] })
  .then(/* … */);

function renderFrame(session, frame) {
  // …

  for (const inputSource of session.inputSources) {
    if (inputSource.hand) {
      // render a hand model, perform gesture detection, etc.
    }
  }
}

Specifications

Specification
WebXR Hand Input Module - Level 1 # dom-xrinputsource-hand

Browser compatibility

BCD tables only load in the browser

See also

XRHand