XRFrame: Methode getHitTestResults()

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Vollständige Kompatibilität anzeigen
Mehr erfahren

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 Methode getHitTestResults() der Schnittstelle XRFrame gibt ein Array von XRHitTestResult-Objekten zurück, die Hit-Test-Ergebnisse für eine bestimmte XRHitTestSource enthalten.

Syntax

getHitTestResults(hitTestSource)

Parameter

hitTestSource: Ein XRHitTestSource-Objekt, das Hit-Test-Abonnements enthält.

Rückgabewert

Ein Array von XRHitTestResult-Objekten.

Um eine Hit-Test-Quelle anzufordern, starten Sie eine XRSession, bei der das Session-Feature hit-test aktiviert ist. Fordern Sie anschließend die Hit-Test-Quelle mit XRSession.requestHitTestSource() an und speichern Sie sie für die spätere Verwendung in der Frame-Schleife. Rufen Sie schließlich getHitTestResults() auf, um die Ergebnisse abzurufen.

const xrSession = navigator.xr.requestSession("immersive-ar", {
  requiredFeatures: ["local", "hit-test"],
});
let hitTestSource = null;
xrSession
  .requestHitTestSource({
    space: viewerSpace, // obtained from xrSession.requestReferenceSpace("viewer");
    offsetRay: new XRRay({ y: 0.5 }),
  })
  .then((viewerHitTestSource) => {
    hitTestSource = viewerHitTestSource;
  });
// frame loop
function onXRFrame(time, xrFrame) {
  let hitTestResults = xrFrame.getHitTestResults(hitTestSource);
  // do things with the hit test results
}