XRInputSource: hand 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

XRInputSource 接口的只读 hand 属性是一个 XRHand 对象,用于访问手部跟踪设备。

如果 XRSession 没有使用 hand-tracking 功能描述符 请求,则返回一个 XRHand 对象或 null

示例

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.
    }
  }
}

规范

规范
WebXR Hand Input 模块 - Level 1
# dom-xrinputsource-hand

浏览器兼容性

另见