XRFrame

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Ein WebXR Device API XRFrame-Objekt wird an die Callback-Funktion requestAnimationFrame() übergeben und bietet Zugriff auf die Informationen, die benötigt werden, um einen einzelnen Animationsframe für eine XRSession zu rendern, die eine VR- oder AR-Szene beschreibt. Ereignisse, die den Tracking-Status von Objekten kommunizieren, liefern ebenfalls eine XRFrame-Referenz als Teil ihrer Struktur.

Zusätzlich zur Bereitstellung einer Referenz zur XRSession, für die dieser Frame gerendert werden soll, wird die Methode getViewerPose() bereitgestellt, um die XRViewerPose zu erhalten, die die Position und Orientierung des Betrachters im Raum beschreibt, und mit getPose() kann man eine XRPose erstellen, die die relative Position eines XRSpace relativ zu einem anderen beschreibt.

Instanzeigenschaften

session Schreibgeschützt Experimentell

Die XRSession, für die dieses XRFrame die Tracking-Details für alle Objekte beschreibt. Die Informationen über ein bestimmtes Objekt können durch Aufrufen einer der Methoden des Objekts abgerufen werden.

trackedAnchors Schreibgeschützt Experimentell

Ein XRAnchorSet, das alle noch im Frame verfolgten Anker enthält.

Instanzmethoden

createAnchor() Experimentell

Gibt ein Promise zurück, das sich zu einem frei schwebenden XRAnchor-Objekt auflöst.

fillJointRadii() Experimentell

Füllt ein Float32Array mit Radien für eine Liste von Handgelenk-Räumen. Gibt true zurück, wenn erfolgreich für alle Räume.

fillPoses() Experimentell

Füllt ein Float32Array mit den Matrizen der Posen in Bezug auf einen gegebenen Basisraum. Gibt true zurück, wenn alle Räume eine gültige Pose haben.

getDepthInformation() Experimentell

Gibt ein XRCPUDepthInformation-Objekt zurück, das die CPU-Tiefeninformationen für den Frame enthält.

getHitTestResults() Experimentell

Gibt ein Array von XRHitTestResult-Objekten zurück, die Hit-Test-Ergebnisse für eine gegebene XRHitTestSource enthalten.

getHitTestResultsForTransientInput() Experimentell

Gibt ein Array von XRTransientInputHitTestResult-Objekten zurück, die Hit-Test-Ergebnisse für eine gegebene XRTransientInputHitTestSource enthalten.

getJointPose() Experimentell

Gibt ein XRJointPose-Objekt zurück, das die Pose eines Handgelenks (siehe XRHand) relativ zu einem gegebenen Basisraum bereitstellt.

getLightEstimate() Experimentell

Gibt ein XRLightEstimate-Objekt zurück, das geschätzte Beleuchtungswerte für ein XRLightProbe enthält.

getPose() Experimentell

Gibt ein XRPose-Objekt zurück, das das räumliche Verhältnis zwischen den beiden angegebenen XRSpace-Objekten darstellt.

getViewerPose() Experimentell

Gibt ein XRViewerPose zurück, das die Position und Orientierung des Betrachters in einem gegebenen XRReferenceSpace beschreibt.

Spezifikationen

Specification
WebXR Device API
# xrframe-interface

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
XRFrame
Experimental
createAnchor
Experimental
fillJointRadii
Experimental
fillPoses
Experimental
getDepthInformation
Experimental
getHitTestResults
Experimental
getHitTestResultsForTransientInput
Experimental
getJointPose
Experimental
getLightEstimate
Experimental
getPose()
Experimental
getViewerPose()
Experimental
session
Experimental
trackedAnchors
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.

Siehe auch