[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/de/docs/Web/API/XRHitTestSource [Back]  [Original]

XRHitTestSource - Web-APIs | MDN

Dieser Inhalt wurde automatisch aus dem Englischen bersetzt, und kann Fehler enthalten. Erfahre mehr ber dieses Experiment.

View in English Always switch to English

XRHitTestSource

Eingeschrnkt verfgbar

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.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen untersttzenden Browsern verfgbar.

Experimentell: Dies ist eine experimentelle Technologie
berprfen Sie die Browser-Kompatibilittstabelle sorgfltig vor der Verwendung auf produktiven Webseiten.

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

Dieses Objekt enthlt selbst keine Hit-Test-Ergebnisse, aber es wird verwendet, um fr jeden XRFrame Hit-Tests zu berechnen, indem XRFrame.getHitTestResults() aufgerufen wird, was XRHitTestResult-Objekte zurckgibt.

In diesem Artikel

Instanz-Eigenschaften

Keine.

Instanz-Methoden

XRHitTestSource.cancel()

Meldet das Abonnement vom Hit-Test ab.

Beispiele

Erhalten eines XRHitTestSource-Objekts fr 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, knnen Sie aufrumen und das XRHitTestSource-Objekt auf null setzen.

js
hitTestSource.cancel();
hitTestSource = null;

Spezifikationen

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

Browser-Kompatibilitt

Siehe auch


Web Proxy Viewer  |  New URL  |  Original Page