XRSession: Methode requestReferenceSpace()
Eingeschränkt verfügbar
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.
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 Methode requestReferenceSpace() der Schnittstelle XRSession gibt ein Promise zurück, das je nach angefordertem Referenzraum mit einer Instanz von XRReferenceSpace oder XRBoundedReferenceSpace erfüllt wird.
Syntax
requestReferenceSpace(referenceSpaceType)
Parameter
type-
Eine Zeichenfolge, die den Typ des Referenzraums angibt, für den eine Instanz zurückgegeben werden soll. Die Zeichenfolge muss einem der unten aufgeführten Werte entsprechen.
Rückgabewert
Ein Promise, das mit einem XRReferenceSpace-Objekt erfüllt wird.
Die Referenzraumtypen sind nachfolgend aufgeführt, zusammen mit kurzen Informationen zu ihren Anwendungsfällen und der Schnittstelle, mit der sie implementiert werden.
bounded-floor-
Ein
XRBoundedReferenceSpace, der dem Typlocalähnelt. Allerdings wird nicht erwartet, dass sich der Benutzer über eine vorab festgelegte Grenze hinausbewegt, die durchboundsGeometryim zurückgegebenen Objekt angegeben wird. local-
Ein
XRReferenceSpace-Referenzraum für das Tracking, dessen nativer Ursprung sich nahe der Position des Betrachters zum Zeitpunkt der Sitzungserstellung befindet. Die genaue Position hängt von der zugrunde liegenden Plattform und Implementierung ab. Es wird erwartet, dass sich der Benutzer kaum oder gar nicht von seiner Ausgangsposition entfernt. Das Tracking ist für diesen Anwendungsfall optimiert. Auf Geräten mit Tracking in sechs Freiheitsgraden (6DoF) versucht der Referenzraumlocal, den Ursprung relativ zur Umgebung stabil zu halten. local-floor-
Ein
XRReferenceSpace, der dem Typlocalähnelt. Die Ausgangsposition wird jedoch an einer sicheren Stelle platziert, an der der Betrachter stehen kann und an der der Wert der y-Achse auf Bodenhöhe 0 beträgt. Wenn die Bodenhöhe nicht bekannt ist, schätzt der User-Agent sie. Wenn die geschätzte Bodenhöhe nicht 0 ist, sollte der Browser sie so runden, dass Fingerprinting vermieden wird (vermutlich auf den nächsten Zentimeter). unbounded-
Ein
XRReferenceSpace-Referenzraum für das Tracking, der dem Benutzer volle Bewegungsfreiheit ermöglicht, möglicherweise auch über sehr große Entfernungen vom Ursprungspunkt. Der Betrachter wird nicht nachverfolgt; das Tracking ist auf Stabilität rund um die aktuelle Position des Benutzers optimiert. Daher kann sich der native Ursprung bei Bedarf verschieben. viewer-
Ein
XRReferenceSpace-Referenzraum für das Tracking, dessen nativer Ursprung der Position und Ausrichtung des Betrachters folgt. Er wird in Umgebungen verwendet, in denen sich der Benutzer physisch bewegen kann, und wird von allenXRSession-Instanzen unterstützt, sowohl immersiven als auch Inline-Sitzungen. Besonders nützlich ist er für Inline-Sitzungen, etwa um den Abstand zwischen dem Betrachter und einer Eingabe zu bestimmen oder mit versetzten Referenzräumen zu arbeiten. Ansonsten wird üblicherweise häufiger einer der anderen Referenzraumtypen verwendet.
Ausnahmen
Statt eine Ausnahme auszulösen, lehnt requestReferenceSpace() das zurückgegebene Promise mit einer DOMException ab, deren Name unten aufgeführt ist:
NotSupportedErrorDOMException-
Der angeforderte Referenzraum wird nicht unterstützt.
Spezifikationen
| Spezifikation |
|---|
| WebXR Device API # dom-xrsession-requestreferencespace |