W3cubDocs

/Web APIs

XRFrame: getJointPose() method

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The getJointPose() method of the XRFrame interface returns an XRJointPose object providing the pose of a hand joint (see XRHand) relative to a given base space.

Syntax

js

getJointPose(joint, baseSpace)

Parameters

joint

An XRJointSpace specifying the hand joint space for which to obtain an XRJointPose describing the item's position and orientation.

baseSpace

An XRSpace to use as the base or origin for the relative position and orientation.

Return value

An XRJointPose object specifying the position and orientation of the hand joint, relative to the XRSpace indicated by baseSpace.

Examples

Using getJointPose()

Call getJointPose() with an XRJointSpace and an XRReferenceSpace to get an XRJointPose object.

js

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

function renderFrame(session, frame) {
  // …

  for (const inputSource of session.inputSources) {
    if (inputSource.hand) {
      const indexFingerTipJoint = inputSource.hand.get("index-finger-tip");
      frame.getJointPose(indexFingerTipJoint, referenceSpace); // XRJointPose
    }
  }
}

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
getJointPose No
93–111Hololens 2 only.
No No No No No No No No No No

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XRFrame/getJointPose