XRSession: Methode requestReferenceSpace()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
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 sich mit einer Instanz von entweder XRReferenceSpace
oder XRBoundedReferenceSpace
auflöst, je nach dem angeforderten Typ des Referenzraums.
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 einer der unten aufgeführten Werte sein.
Rückgabewert
Ein Promise
, das sich mit einem XRReferenceSpace
-Objekt auflöst.
Die Arten von Referenzräumen sind unten aufgeführt, mit kurzen Informationen über ihre Anwendungsfälle und welches Interface zur Implementierung verwendet wird.
bounded-floor
-
Ein
XRBoundedReferenceSpace
, ähnlich dem Typlocal
, außer dass der Benutzer nicht erwartet wird, sich außerhalb einer vorbestimmten Grenze zu bewegen, die durch dieboundsGeometry
im zurückgegebenen Objekt angegeben ist. local
-
Ein
XRReferenceSpace
-Trackingraum, dessen Ursprung in der Nähe der Position des Betrachters zum Zeitpunkt der Erstellung der Sitzung liegt. Die genaue Position hängt von der zugrunde liegenden Plattform und Implementierung ab. Es wird nicht erwartet, dass sich der Benutzer weit über seine Ausgangsposition hinaus bewegt, und das Tracking ist für diesen Anwendungsfall optimiert. Für Geräte mit sechs Freiheitsgraden (6DoF)-Tracking versucht derlocal
Referenzraum den Ursprung relativ zur Umgebung stabil zu halten. local-floor
-
Ein
XRReferenceSpace
, ähnlich dem Typlocal
, jedoch ist die Startposition an einem sicheren Ort für den Betrachter positioniert, wo der Wert der y-Achse auf 0 auf Bodenhöhe gesetzt ist. Wenn diese Bodenhöhe nicht bekannt ist, schätzt der user agent die Bodenhöhe. Wenn die geschätzte Bodenhöhe ungleich null ist, wird vom Browser erwartet, dass er sie so rundet, dass Fingerabdruckerkennung vermieden wird (wahrscheinlich auf den nächsten Zentimeter). unbounded
-
Ein
XRReferenceSpace
-Trackingraum, der dem Benutzer völlige Bewegungsfreiheit ermöglicht, möglicherweise über extrem lange Distanzen von ihrem Ursprungspunkt hinweg. Der Betrachter wird überhaupt nicht 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 diesem Bedürfnis gerecht zu werden. viewer
-
Ein
XRReferenceSpace
-Trackingraum, dessen nativem Ursprung die Position und Orientierung des Betrachters verfolgt. Dies wird für 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, wenn der Abstand zwischen dem Betrachter und einer Eingabe ermittelt werden soll oder wenn mit Offset-Räumen gearbeitet wird. Andernfalls wird in der Regel einer der anderen Referenzraumtypen häufiger verwendet.
Ausnahmen
Statt echte Ausnahmen auszulösen, 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
Specification |
---|
WebXR Device API # dom-xrsession-requestreferencespace |
Browser-Kompatibilität
BCD tables only load in the browser