XRFrame: getViewerPose()-Methode
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 getViewerPose()
-Methode, ein Mitglied der XRFrame
-Schnittstelle, gibt ein XRViewerPose
-Objekt zurück, welches die Pose (Position und Orientierung) des Betrachters relativ zum angegebenen Referenzraum beschreibt.
Sehen Sie sich die getPose()
-Methode an, um eine Pose zu berechnen, die die Differenz zwischen zwei Räumen darstellt.
Syntax
getViewerPose(referenceSpace)
Parameter
referenceSpace
-
Ein
XRReferenceSpace
-Objekt, das den Raum angibt, der als Referenzpunkt oder Basis für die Berechnung der aktuellen Pose des Betrachters verwendet werden soll.
Rückgabewert
Ein XRViewerPose
, das die Position und Orientierung des Betrachters relativ zum angegebenen Referenzraum beschreibt.
Ausnahmen
InvalidStateError
DOMException
-
Wird ausgelöst, wenn
getViewerPose()
nicht im Kontext eines Rückrufs anXRSession.requestAnimationFrame()
einer Sitzung aufgerufen wurde.
Beispiele
In dieser Rückruffunktion für requestAnimationFrame()
wird die XRViewerPose
, die den Blickpunkt des Betrachters auf die Welt beschreibt, durch Aufrufen von getViewerPose()
auf dem an den Rückruf übergebenen XRFrame
erhalten.
viewerPose = xrFrame.getViewerPose(xrReferenceSpace);
if (viewerPose) {
/* render the pose's views */
}
Um ein vollständiges Beispiel zu sehen, schauen Sie sich Bewegung, Orientierung und Bewegung an.
Spezifikationen
Specification |
---|
WebXR Device API # dom-xrframe-getviewerpose |
Browser-Kompatibilität
BCD tables only load in the browser