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

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

BCD tables only load in the browser

Siehe auch