XRFrame: getHitTestResultsForTransientInput()-Methode

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, bevor Sie diese produktiv verwenden.

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

Die getHitTestResultsForTransientInput()-Methode des XRFrame-Interfaces liefert ein Array von XRTransientInputHitTestResult-Objekten, die transiente Eingabe-Hit-Test-Ergebnisse für eine gegebene XRTransientInputHitTestSource enthalten.

Syntax

js
getHitTestResultsForTransientInput(hitTestSource)

Parameter

hitTestSource

Ein XRTransientInputHitTestSource-Objekt, das transiente Eingabe-Hit-Test-Abonnements enthält.

Rückgabewert

Ein Array von XRTransientInputHitTestResult-Objekten.

Beispiele

Abrufen von transienten Eingabe-Hit-Test-Ergebnissen

Um eine Quelle für transiente Eingabe-Hit-Tests anzufordern, starten Sie eine XRSession mit dem aktivierten hit-test-Sitzungsfeature. Fordern Sie anschließend die Hit-Test-Quelle mit XRSession.requestHitTestSourceForTransientInput() an und speichern Sie sie für die spätere Verwendung in der Frame-Schleife. Rufen Sie schließlich getHitTestResultsForTransientInput() auf, um das Ergebnis zu erhalten.

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
}

Spezifikationen

Specification
WebXR Hit Test Module
# dom-xrframe-gethittestresultsfortransientinput

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch