XRSession: requestReferenceSpace()-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 requestReferenceSpace()-Methode des XRSession-Interfaces gibt ein Promise zurück, das mit einer Instanz von entweder XRReferenceSpace oder XRBoundedReferenceSpace aufgelöst wird, je nachdem, welcher Typ von Referenzraum angefordert wurde.
Syntax
requestReferenceSpace(referenceSpaceType)
Parameter
type-
Ein String, der den Typ des Referenzraums angibt, für den eine Instanz zurückgegeben werden soll. Der String muss einen der unten stehenden Werte haben.
Rückgabewert
Ein Promise, das mit einem XRReferenceSpace-Objekt aufgelöst wird.
Die Typen der Referenzräume sind unten aufgelistet, mit kurzen Informationen zu ihren Anwendungsfällen und welchem Interface sie implementieren.
bounded-floor-
Ein
XRBoundedReferenceSpace, ähnlich demlocal-Typ, jedoch wird nicht erwartet, dass sich der Benutzer außerhalb einer vorgegebenen Grenze bewegt, die durch dieboundsGeometryim zurückgegebenen Objekt angegeben wird. local-
Ein
XRReferenceSpace, dessen nativer Ursprung sich in der Nähe der Position des Betrachters zum Zeitpunkt der Sitzungserstellung befindet. Der genaue Ort hängt von der zugrunde liegenden Plattform und Implementierung ab. Es wird nicht erwartet, dass sich der Benutzer weit von seiner Startposition entfernt, und das Tracking ist für diesen Anwendungsfall optimiert. Für Geräte mit sechs Freiheitsgraden (6DoF)-Tracking versucht derlocal-Referenzraum den Ursprung stabil relativ zur Umgebung zu halten. local-floor-
Ein
XRReferenceSpace, ähnlich demlocal-Typ, jedoch wird die Startposition an einem sicheren Ort für den Betrachter platziert, wo der Wert der y-Achse auf Bodenhöhe 0 ist. Falls diese Bodenhöhe nicht bekannt ist, schätzt der User Agent die Bodenhöhe. Wenn die geschätzte Bodenhöhe nicht null ist, wird erwartet, dass der Browser sie auf eine Weise rundet, um Fingerabdruck zu vermeiden (vermutlich auf den nächsten Zentimeter). unbounded-
Ein
XRReferenceSpace, der dem Benutzer völlige Bewegungsfreiheit ermöglicht, möglicherweise über extrem große Entfernungen vom Ursprungspunkt. Der Betrachter wird nicht dauerhaft verfolgt; das Tracking ist für Stabilität um die aktuelle Position des Benutzers optimiert, sodass sich der native Ursprung nach Bedarf verschieben kann, um dieser Anforderung gerecht zu werden. viewer-
Ein
XRReferenceSpace, dessen nativer Ursprung die Position und Orientierung des Betrachters verfolgt. Dies wird in Umgebungen verwendet, in denen sich der Benutzer physisch bewegen kann, und wird von allen Instanzen vonXRSession, sowohl immersiv als auch inline, unterstützt, obwohl es für inline-Sitzungen am nützlichsten ist. Es ist besonders nützlich, um den Abstand zwischen dem Betrachter und einer Eingabe zu bestimmen oder beim Arbeiten mit Versatzräumen. Ansonsten wird typischerweise einer der anderen Referenzraumtypen häufiger verwendet.
Ausnahmen
Anstatt echte Ausnahmen zu werfen, lehnt requestReferenceSpace() das zurückgegebene Promise mit einem DOMException ab, dessen Name in der folgenden Liste zu finden ist:
NotSupportedError-
Der angeforderte Referenzraum wird nicht unterstützt.
Spezifikationen
| Spezifikation |
|---|
| WebXR Device API # dom-xrsession-requestreferencespace |