XRSession: requestHitTestSourceForTransientInput()-Methode - Web-APIs | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

XRSession: requestHitTestSourceForTransientInput()-Methode

Eingeschränkt verfügbar

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

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 requestHitTestSourceForTransientInput()-Methode der XRSession-Schnittstelle gibt ein Promise zurück, das mit einem XRTransientInputHitTestSource-Objekt aufgelöst wird, das an XRFrame.getHitTestResultsForTransientInput() übergeben werden kann.

In diesem Artikel

Syntax

requestHitTestSourceForTransientInput(options)

Parameter

options

Ein Objekt mit Konfigurationsoptionen, speziell:

profile

Ein String, der den Eingabeprofilnamen der transienten Eingabequelle angibt, die zur Berechnung der Trefferergebnisse verwendet wird.

entityTypes Optional

Ein Array, das die Typen von Entitäten spezifiziert, die zur Erstellung der Trefferquelle verwendet werden sollen. Wenn kein Entitätstyp angegeben ist, standardisiert das Array auf ein einzelnes Element mit dem Typ plane. Mögliche Typen:

point: Berechnen Sie Trefferergebnisse basierend auf charakteristischen Punkten, die erkannt wurden.
plane: Berechnen Sie Trefferergebnisse basierend auf realen Ebenen, die erkannt wurden.
mesh: Berechnen Sie Trefferergebnisse basierend auf erkannten Netzen.

offsetRay Optional

Das XRRay-Objekt, das zur Durchführung des Treffers verwendet wird. Wenn kein XRRay-Objekt bereitgestellt wurde, wird ein neues XRRay-Objekt ohne Parameter konstruiert.

Rückgabewert

Ein Promise das mit einem XRTransientInputHitTestSource-Objekt aufgelöst wird.

Ausnahmen

Statt echte Ausnahmen zu werfen, lehnt requestHitTestSourceForTransientInput() das zurückgegebene Promise mit einem DOMException ab, insbesondere einer der folgenden:

NotSupportedError DOMException

Wird ausgelöst, wenn hit-test kein aktiviertes Feature in XRSystem.requestSession() ist.

InvalidStateError DOMException

Wird ausgelöst, wenn die Sitzung bereits beendet wurde.

NotAllowedError DOMException

Wird ausgelöst, wenn eine unangemessene Anzahl von Anfragen vorliegt. Einige Benutzeragenten könnten die Nutzung aus Datenschutzgründen einschränken.

Beispiele

Anfordern einer transienten Trefferquelle

Um eine Trefferquelle anzufordern, starten Sie eine XRSession mit dem aktivierten hit-test-Sitzungs-Feature. Konfigurieren Sie anschließend die Trefferquelle und speichern Sie sie für die spätere Verwendung in der Frameroutine und rufen Sie XRFrame.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
}

XRSession.requestHitTestSource()

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
XRSession
Instanzeigenschaften
Instanzmethoden
Events
Vererbung
1. EventTarget
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