XRSession：requestHitTestSourceForTransientInput() 方法

options

包含配置选项的对象，具体来说：

profile

一个字符串，指定将用于计算命中测试结果的瞬态输入源的 输入配置文件名称。

entityTypes 可选

一个 Array，指定用于创建命中测试源的实体类型。如果未指定实体类型，则数组默认为包含 plane 类型的单个元素。可能的类型：

• point：基于检测到的特征点计算命中测试结果。
• plane：基于检测到的现实世界平面计算命中测试结果。
• mesh：基于检测到的网格计算命中测试结果。

offsetRay 可选

将用于执行命中测试的 XRRay 对象。如果未提供 XRRay 对象，则会构造一个不带任何参数的新 XRRay 对象。

一个 Promise，该 Promise 解析为一个 XRTransientInputHitTestSource 对象。

requestHitTestSourceForTransientInput() 不会抛出真正的异常，而是会拒绝返回的 Promise，并使用一个 DOMException 作为拒绝原因，具体如下：

NotSupportedError DOMException

如果 XRSystem.requestSession() 中未启用“hit-test”功能，则会抛出此异常。

InvalidStateError DOMException

如果会话已结束，则会抛出此异常。

NotAllowedError DOMException

如果请求过多，则会抛出此异常。出于隐私原因，某些用户代理可能会限制使用次数。

要请求命中测试源，请启用“hit-test”会话功能启动一个 XRSession。接下来，配置命中测试源并将其存储以供以后在帧循环中使用，并调用 XRFrame.getHitTestResultsForTransientInput() 获取结果。

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
}

• XRSession.requestHitTestSource()