XRLightEstimate

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.

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 Experimentell: Ein DOMPointReadOnly, der die Richtung zur primären Lichtquelle vom probeSpace einer XRLightProbe darstellt.
XRLightEstimate.primaryLightIntensity Schreibgeschützt Experimentell: 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 Experimentell: 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;
}