XRReferenceSpace

Instanz-Eigenschaften

XRReferenceSpace erbt die Eigenschaften von EventTarget, definiert aber keine zustzlichen Eigenschaften.

Instanz-Methoden

XRReferenceSpace erbt auch Methoden von EventTarget zustzlich zu den folgenden Methoden.

getOffsetReferenceSpace()

Erstellt und gibt ein neues Referenzraumobjekt des gleichen Typs zurck, auf dem Sie die Methode aufrufen (also entweder XRReferenceSpace oder XRBoundedReferenceSpace). Der neue Referenzraum kann verwendet werden, um ein Koordinatensystem von dem Referenzraum des Objekts, auf dem die Methode aufgerufen wird, in ein anderes Koordinatensystem zu transformieren. Dies ist ntzlich zum Positionieren von Objekten beim Rendern und zum Ausfhren der bentigten Transformationen, wenn die Position und/oder Ausrichtung des Betrachters im 3D-Raum gendert werden.

Ereignisse

reset

Das reset-Ereignis wird an ein XRReferenceSpace-Objekt gesendet, wenn der Browser eine Diskontinuitt zwischen dem Ursprung des verfolgten Objekts und der Umgebung oder dem Standort des Nutzers erkennt. Dies kann zum Beispiel passieren, nachdem der Nutzer sein XR-Gert neu kalibriert hat oder wenn das Gert seinen Ursprung automatisch anpasst, nachdem das Tracking verloren und wiederhergestellt wurde.

Referenzraumtypen

Die Arten von Referenzrumen sind in der Tabelle unten aufgelistet, mit kurzen Informationen zu ihren Anwendungsfllen und welche Schnittstelle verwendet wird, um sie zu implementieren.

bounded-floor

Ein XRBoundedReferenceSpace, der dem local-Typ hnlich ist, auer dass der Nutzer nicht erwartet wird, sich auerhalb eines vorgegebenen Bereichs zu bewegen, der durch die boundsGeometry im zurckgegebenen Objekt angegeben wird.

local

Ein XRReferenceSpace-Verfolgungsraum, dessen nativer Ursprung sich nahe der Position des Nutzers befindet zu dem Zeitpunkt, zu dem die Sitzung erstellt wurde. Die genaue Position hngt von der zugrunde liegenden Plattform und Implementierung ab. Der Nutzer wird nicht erwartet, sich wesentlich ber seine Ausgangsposition hinaus zu bewegen, und das Tracking ist fr diesen Anwendungsfall optimiert. Fr Gerte mit sechs Freiheitsgraden (6DoF) Tracking versucht der local-Referenzraum, den Ursprung stabil in Bezug auf die Umgebung zu halten.

local-floor

Ein XRReferenceSpace, der dem local-Typ hnelt, auer dass die Ausgangsposition an einem sicheren Ort fr den Nutzer platziert wird, wobei der Wert der y-Achse bei 0 auf Bodenebene liegt. Wenn diese Bodenebene nicht bekannt ist, wird der Benutzeragent die Bodenebene schtzen. Wenn die geschtzte Bodenebene ungleich null ist, wird erwartet, dass der Browser sie in einer Weise aufrundet, die Fingerprinting vermeidet (wahrscheinlich auf den nchsten Zentimeter).

unbounded

Ein XRReferenceSpace-Verfolgungsraum, der dem Nutzer vllige Bewegungsfreiheit erlaubt, mglicherweise ber extrem lange Distanzen von ihrem Ursprungspunkt. Der Betrachter wird berhaupt nicht verfolgt; das Tracking wird fr Stabilitt um die aktuelle Position des Nutzers optimiert, daher kann der native Ursprung nach Bedarf driften, um diesem Bedarf gerecht zu werden.

viewer

Ein XRReferenceSpace-Verfolgungsraum, dessen nativer Ursprung die Position und Ausrichtung des Betrachters verfolgt. Dies wird fr Umgebungen verwendet, in denen sich der Nutzer physisch bewegen kann und wird von allen Instanzen von XRSession untersttzt, sowohl immersiv als auch inline, obwohl es fr Inline-Sitzungen am ntzlichsten ist. Es ist besonders ntzlich, um die Entfernung zwischen dem Betrachter und einer Eingabe zu bestimmen oder beim Arbeiten mit Versatzrumen. Andernfalls wird typischerweise einer der anderen Referenzraumtypen hufiger verwendet.

Nutzungshinweise

Erstellen eines XRReferenceSpace

Es gibt zwei Situationen, in denen Sie ein XRReferenceSpace erhalten mssen. Die erste ist, wenn Sie Ihre Szene einrichten und einen Referenzraum bentigen, um fr die Dauer der XRSession den Standpunkt des Benutzers auf die Welt darzustellen. Um dies zu tun, rufen Sie die Methode requestReferenceSpace() der XRSession auf und geben Sie den Referenzraumtyp an, den Sie erhalten mchten.

xrSession.requestReferenceSpace("local").then((refSpace) => {
  xrReferenceSpace = refSpace;
  // 
});

Die andere Situation, in der Sie mglicherweise einen neuen Referenzraum bentigen, ist, wenn Sie den Ursprung an eine neue Position verschieben mssen; dies wird hufig getan, zum Beispiel, wenn Ihr Projekt dem Nutzer erlaubt, sich mit Eingabegerten wie Tastatur, Maus, Touchpad oder Spielsteuerungen, die nicht ber das XR-Gert verbunden sind, durch die Umgebung zu bewegen. Da der Ursprung typischerweise der Standort des Nutzers im Raum ist, mssen Sie den Ursprung ndern, um deren Bewegungen und Orientierungsnderungen widerzuspiegeln.

Um die Ansicht des Nutzers auf die Welt zu bewegen oder zu drehen, mssen Sie das XRReferenceSpace, das diesen Blickwinkel darstellt, ndern. XRReferenceSpace ist jedoch unvernderlich, daher mssen Sie stattdessen einen neuen Referenzraum erstellen, der den genderten Blickwinkel darstellt. Dies ist leicht mit der Methode getOffsetReferenceSpace() zu erreichen.

let offsetTransform = new XRRigidTransform(
  { x: 2, y: 0, z: 1 },
  { x: 0, y: 0, z: 0, w: 1 },
);
xrReferenceSpace = xrReferenceSpace.getOffsetReferenceSpace(offsetTransform);

Dies ersetzt das XRReferenceSpace durch ein neues, dessen Ursprung und Ausrichtung angepasst sind, um den neuen Ursprung bei (2, 0, 1) relativ zum aktuellen Ursprung zu platzieren und rotiert mit einem Einheit-Quaternion, das den Raum so orientiert, dass der Betrachter relativ zur vorherigen Weltorientierung nach oben schaut.

Geometrie

Der native Ursprung eines XRReferenceSpace wird immer so konfiguriert, dass +X als rechts, +Y als aufwrts und +Z als "rckwrts" oder in Richtung des Nutzers betrachtet wird.

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Grundlagen von WebXR
• Geometrie und Referenzrume in WebXR
• Ansichtspunkte und Betrachter: Kameras in WebXR simulieren
• Mathematik mit Matrizen fr das Web
• Bewegung, Orientierung und Bewegungsablufe
• Verwendung von begrenzten Referenzrumen, um den Nutzer zu schtzen