XRFrame: getHitTestResultsForTransientInput() 方法

可用性有限

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

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

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

XRFrame 接口的 getHitTestResultsForTransientInput() 方法返回一个 XRTransientInputHitTestResult 对象数组,其中包含给定 XRTransientInputHitTestSource 的瞬态输入命中测试结果。

语法

js
getHitTestResultsForTransientInput(hitTestSource)

参数

hitTestSource

一个 XRTransientInputHitTestSource 对象,其中包含瞬态输入命中测试订阅。

返回值

一个 XRTransientInputHitTestResult 对象数组。

示例

获取瞬态输入命中测试结果

要请求瞬态输入命中测试源,请使用启用了 hit-test 会话功能的 XRSession 启动会话。接下来,使用 XRSession.requestHitTestSourceForTransientInput() 请求命中测试源,并将其存储在帧循环中以备后用。最后,调用 getHitTestResultsForTransientInput() 来获取结果。

js
const xrSession = navigator.xr.requestSession("immersive-ar", {
  requiredFeatures: ["local", "hit-test"],
});

let transientHitTestSource = null;
xrSession
  .requestHitTestSourceForTransientInput({
    profile: "generic-touchscreen",
    offsetRay: new XRRay(),
  })
  .then((touchScreenHitTestSource) => {
    transientHitTestSource = touchScreenHitTestSource;
  });

// frame loop
function onXRFrame(time, xrFrame) {
  let hitTestResults = xrFrame.getHitTestResultsForTransientInput(
    transientHitTestSource,
  );
  // do things with the transient hit test results
}

规范

规范
WebXR Hit Test 模块
# dom-xrframe-gethittestresultsfortransientinput

浏览器兼容性

另见