XRTransientInputHitTestResult: results-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte results-Eigenschaft der XRTransientInputHitTestResult-Schnittstelle stellt ein Array von XRHitTestResult-Objekten dar, das die Trefferergebnisse für die Eingabequelle enthält. Diese sind nach der Entfernung entlang des Strahls, der für den Treffertest verwendet wurde, geordnet, wobei das nächstgelegene Ergebnis an Position 0 steht.

Wert

Ein Array von XRHitTestResult-Objekten.

Beispiele

Zugriff auf temporäre Eingabe-Treffertestergebnisse

Zwei Arrays werden verwendet, um auf temporäre Eingabe-Treffertestergebnisse zuzugreifen. Zuerst erhalten Sie ein Array von XRTransientInputHitTestResult-Objekten durch den Aufruf von XRFrame.getHitTestResultsForTransientInput(). Zweitens, um zu den tatsächlichen XRHitTestResult-Objekten für eine Eingabequelle zu gelangen, greifen Sie auf die results-Eigenschaft eines der XRTransientInputHitTestResult-Objekte zu.

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);
    });
  });
}

Spezifikationen

Specification
WebXR Hit Test Module
# dom-xrtransientinputhittestresult-results

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch