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, bevor Sie diese produktiv verwenden.

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 Nur lesbar

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 Nur lesbar

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

Instanzmethoden

createAnchor()

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

fillJointRadii()

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()

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()

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

getHitTestResults()

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

getHitTestResultsForTransientInput()

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

getJointPose()

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

getLightEstimate()

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

getPose()

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

getViewerPose()

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

BCD tables only load in the browser

Siehe auch