XRLightEstimate: primaryLightIntensity-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte primaryLightIntensity-Eigenschaft des XRLightEstimate-Interfaces gibt ein DOMPointReadOnly zurück, das die Intensität der primären Lichtquelle aus dem probeSpace einer XRLightProbe darstellt.

Wert

Ein DOMPointReadOnly-Objekt, bei dem ein RGB-Wert den x, y und z-Werten zugeordnet ist. Der w-Wert ist immer 1.0. Wenn keine geschätzten Werte aus der Umgebung des Nutzers verfügbar sind, wird der Punkt {x: 0.0, y: 0.0, z: 0.0, w: 1.0} sein, was keine Beleuchtung darstellt.

Beispiele

Innerhalb einer XRFrame-Schleife können Sie die Eigenschaften primaryLightDirection und primaryLightIntensity verwenden, um beispielsweise Schatten basierend auf der am meisten hervorstechenden Lichtquelle zu rendern.

js
const lightProbe = await xrSession.requestLightProbe();

// frame loop
function onXRFrame(time, xrFrame) {
  let lightEstimate = xrFrame.getLightEstimate(lightProbe);

  // Render lights

  // Available properties
  lightEstimate.primaryLightDirection;
  lightEstimate.primaryLightIntensity;
}

Spezifikationen

Specification
WebXR Lighting Estimation API Level 1
# dom-xrlightestimate-primarylightintensity

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
primaryLightIntensity
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.

Siehe auch