Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.
XRFrame: getHitTestResults() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more support for this feature? Tell us why.
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 getHitTestResults() Methode der XRFrame-Schnittstelle gibt ein Array von XRHitTestResult-Objekten zurück, die Hit-Test-Ergebnisse für eine gegebene XRHitTestSource enthalten.
Syntax
getHitTestResults(hitTestSource)
Parameter
hitTestSource-
Ein
XRHitTestSource-Objekt, das Hit-Test-Abonnements enthält.
Rückgabewert
Ein Array von XRHitTestResult-Objekten.
Beispiele
Abrufen von Hit-Test-Ergebnissen
Um eine Hit-Test-Quelle anzufordern, starten Sie eine XRSession mit der aktivierten Sitzungsfunktion hit-test. Fordern Sie als nächstes die Hit-Test-Quelle mit XRSession.requestHitTestSource() an und speichern Sie sie zur späteren Verwendung in der Frame-Schleife. Rufen Sie schließlich getHitTestResults() auf, um das Ergebnis zu erhalten.
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
}
Spezifikationen
| Spezifikation |
|---|
| WebXR Hit Test Module # dom-xrframe-gethittestresults |
Browser-Kompatibilität
JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.