XRHitTestSource

Eingeschränkt verfügbar

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

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

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

Das XRHitTestSource Interface der WebXR Device API verwaltet Hit-Test-Abonnements. Sie können ein XRHitTestSource-Objekt mit der Methode XRSession.requestHitTestSource() erhalten.

Dieses Objekt enthält selbst keine Hit-Test-Ergebnisse, aber es wird verwendet, um für jeden XRFrame Hit-Tests zu berechnen, indem XRFrame.getHitTestResults() aufgerufen wird, was XRHitTestResult-Objekte zurückgibt.

In diesem Artikel

Instanz-Eigenschaften

Keine.

Instanz-Methoden

XRHitTestSource.cancel()

Meldet das Abonnement vom Hit-Test ab.

Beispiele

Erhalten eines XRHitTestSource-Objekts für eine Sitzung

Rufen Sie XRSession.requestHitTestSource() auf, um eine Hit-Test-Quelle zu erhalten.

js
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
}

Vom Hit-Test abmelden

Um sich von einer Hit-Test-Quelle abzumelden, rufen Sie XRHitTestSource.cancel() auf. Da das Objekt nicht mehr verwendbar ist, können Sie aufräumen und das XRHitTestSource-Objekt auf null setzen.

js
hitTestSource.cancel();
hitTestSource = null;

Spezifikationen

Spezifikation

WebXR Hit Test Module
# hit-test-source-interface

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

XRTransientInputHitTestSource

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

WebXR Device API
XRHitTestSource
Instanzmethoden
1. cancel()
Verwandte Seiten für WebXR Device API
Anleitungen
1. Grundlagen von WebXR
2. Lebenszyklus einer WebXR-Anwendung
3. Starten und Beenden einer WebXR-Sitzung
4. Geometrie und Referenzräume im WebXR
5. Räume und Referenzräume: Räumliches Tracking in WebXR
6. Rendering und der WebXR-Frame-Animationsrückruf
7. Blickpunkte und Betrachter: Kamerasimulation in WebXR
8. Eine perspektivische Rückschau für WebXR-Entwickler
9. Beleuchtung einer WebXR-Umgebung
10. Verwendung von begrenzten Referenzräumen
11. Bewegung, Orientierung und Bewegung: Ein WebXR-Beispiel
12. Eingaben und Eingabequellen
13. Targeting und Treffererkennung
14. WebXR-Leitfaden zur Leistungsoptimierung
15. WebXR-Berechtigungen und Sicherheit