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.

Instanzmethoden

Keine.

Beispiele

Erhalt eines XRLightProbe-Objekts

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.

js
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;
}

Spezifikationen

Specification
WebXR Lighting Estimation API Level 1
# xrlightestimate-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
XRLightEstimate
Experimental
primaryLightDirection
Experimental
primaryLightIntensity
Experimental
sphericalHarmonicsCoefficients
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