XRTransientInputHitTestResult: results 属性

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

安全上下文: 此功能仅在 安全上下文(HTTPS)中可用,在某些或所有 支持的浏览器 中。

XRTransientInputHitTestResult 接口的 只读 results 属性表示一个 XRHitTestResult 对象数组,这些对象包含输入源的命中测试结果,按执行命中测试所用射线上的距离排序,最接近的结果位于位置 0。

XRHitTestResult 对象数组。

示例

访问瞬态输入命中测试结果

使用两个数组来访问瞬态输入命中测试结果。首先,通过调用 XRFrame.getHitTestResultsForTransientInput() 获取一个 XRTransientInputHitTestResult 对象数组。其次,要获取输入源的实际 XRHitTestResult 对象,需要取消引用 XRTransientInputHitTestResult 对象之一上的 results 属性。

js
// frame loop
function onXRFrame(time, xrFrame) {
  let hitTestResults = xrFrame.getHitTestResultsForTransientInput(
    transientHitTestSource,
  );

  hitTestResults.forEach((resultsPerInputSource) => {
    resultsPerInputSource.results.forEach((hitTest) => {
      // do something with the hit test
      hitTest.getPose(referenceSpace);
    });
  });
}

规范

规范
WebXR 命中测试模块
# dom-xrtransientinputhittestresult-results

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅