XRLightProbe: reflectionchange-Event

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.

Das WebXR-reflectionchange-Event wird jedes Mal ausgelöst, wenn sich die geschätzte Reflexions-Würfelkarte ändert. Dies geschieht als Reaktion auf Bewegungen durch verschiedene Lichtbedingungen oder auf direkte Änderungen der Beleuchtung selbst. Dieses Ereignis kann nicht abgebrochen werden.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("reflectionchange", (event) => { })

onreflectionchange = (event) => { }

Ereignistyp

Beispiele

Verwendung des reflectionchange-Events

Jedes Mal, wenn das reflectionchange-Event bei einem Light Probe ausgelöst wird, können Sie eine aktualisierte Würfelkarte abrufen, indem Sie XRWebGLBinding.getReflectionCubeMap() aufrufen. Dies ist weniger kostspielig, als Beleuchtungsinformationen mit jedem XRFrame abzurufen.

js
const glBinding = new XRWebGLBinding(xrSession, gl);
const lightProbe = await xrSession.requestLightProbe();
let glCubeMap = glBinding.getReflectionCubeMap(lightProbe);

lightProbe.addEventListener("reflectionchange", () => {
  glCubeMap = glBinding.getReflectionCubeMap(lightProbe);
});

Die onreflectionchange-Ereignishandler-Eigenschaft

Das reflectionchange-Event ist auch über die onreflectionchange-Ereignishandler-Eigenschaft verfügbar.

js
lightProbe.onreflectionchange = (event) => {
  glCubeMap = glBinding.getReflectionCubeMap(lightProbe);
};

Spezifikationen

Specification
WebXR Lighting Estimation API Level 1
# eventdef-xrlightprobe-reflectionchange
WebXR Lighting Estimation API Level 1
# dom-xrlightprobe-onreflectionchange

Browser-Kompatibilität

Siehe auch