XRLightEstimate

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more support for this feature? Tell us why.

Mehr erfahren
Vollständige Kompatibilität anzeigen

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.

Die XRLightEstimate-Schnittstelle der WebXR Device API liefert die geschätzten Lichtwerte für eine XRLightProbe zu dem Zeitpunkt, der durch ein XRFrame dargestellt wird.

Um ein XRLightEstimate-Objekt zu erhalten, rufen Sie die Methode XRFrame.getLightEstimate() auf.

Instanzeigenschaften

XRLightEstimate.primaryLightDirection Schreibgeschützt: Ein DOMPointReadOnly, der die Richtung zur primären Lichtquelle vom probeSpace einer XRLightProbe darstellt.
XRLightEstimate.primaryLightIntensity Schreibgeschützt: Ein DOMPointReadOnly (mit den x, y, z Werten auf RGB abgebildet), der die Intensität der primären Lichtquelle vom probeSpace einer XRLightProbe darstellt.
XRLightEstimate.sphericalHarmonicsCoefficients Schreibgeschützt: Ein Float32Array, das 9 Kugeloberflächenharmonische Koeffizienten enthält.

Verwenden Sie zunächst die Methode XRSession.requestLightProbe(), um eine Lichtsonde von einer Sitzung zu erhalten. Innerhalb einer XRFrame-Schleife gibt die Methode getLightEstimate() ein XRLightEstimate-Objekt zurück, das die Lichtwerte für jeden Frame enthält.

const lightProbe = await xrSession.requestLightProbe();
// frame loop
function onXRFrame(time, xrFrame) {
 let lightEstimate = xrFrame.getLightEstimate(lightProbe);
 // Use light estimate data to light the scene
 // Available properties
 lightEstimate.sphericalHarmonicsCoefficients;
 lightEstimate.primaryLightDirection;
 lightEstimate.primaryLightIntensity;
}