XRLightProbe: reflectionchange-Ereignis
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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-Ereignis reflectionchange wird jedes Mal ausgelöst, wenn sich die geschätzte Reflection Cube Map ändert. Dies geschieht, wenn sich Benutzer durch Bereiche mit unterschiedlichen Lichtverhältnissen bewegen oder wenn sich die Beleuchtung selbst direkt ändert. Dieses Ereignis kann nicht abgebrochen werden.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("reflectionchange", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onreflectionchange = (event) => { }
Ereignistyp
Beispiele
Das Ereignis reflectionchange verwenden
Wenn das Ereignis reflectionchange auf einer Light Probe ausgelöst wird, können Sie durch Aufrufen von XRWebGLBinding.getReflectionCubeMap() eine aktualisierte Cube Map abrufen. Dies ist weniger aufwendig, als Beleuchtungsinformationen bei jedem XRFrame abzurufen.
const glBinding = new XRWebGLBinding(xrSession, gl);
const lightProbe = await xrSession.requestLightProbe();
let glCubeMap = glBinding.getReflectionCubeMap(lightProbe);
lightProbe.addEventListener("reflectionchange", () => {
glCubeMap = glBinding.getReflectionCubeMap(lightProbe);
});
Die Event-Handler-Eigenschaft onreflectionchange
Das Ereignis reflectionchange ist auch über die Event-Handler-Eigenschaft onreflectionchange verfügbar. Beachten Sie jedoch, dass dadurch andere mit onreflectionchange hinzugefügte Event-Listener ersetzt werden, sofern vorhanden.
lightProbe.onreflectionchange = (event) => {
glCubeMap = glBinding.getReflectionCubeMap(lightProbe);
};
Spezifikationen
| Spezifikation |
|---|
| WebXR Lighting Estimation API Level 1 # eventdef-xrlightprobe-reflectionchange |
| WebXR Lighting Estimation API Level 1 # dom-xrlightprobe-onreflectionchange |