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

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

Ein DOMPointReadOnly, der die Richtung zur primären Lichtquelle vom probeSpace einer XRLightProbe darstellt.

XRLightEstimate.primaryLightIntensity Nur lesbar

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

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

BCD tables only load in the browser

Siehe auch