XRSession: preferredReflectionFormat-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 Eigenschaft preferredReflectionFormat des XRSession-Interfaces gibt das bevorzugte Reflektionsformat dieser Sitzung zurück, das für Texturdaten zur Beleuchtungsschätzung verwendet wird.

Wert

Ein String, der das Reflektionsformat darstellt. Mögliche Werte:

XRReflectionFormat WebGL-Format WebGL-Internes Format WebGPU-Format HDR
"srgba8" RGBA SRGB8_ALPHA8 "rgba8unorm-srgb"
"rgba16f" RGBA RGBA16F "rgba16float"

Beispiele

Anfordern einer Lichtsonde mit dem bevorzugten Format des Systems

Sie können eine Lichtsonde mit XRSession.requestLightProbe() anfordern und das bevorzugte Format des Systems angeben, indem Sie die reflectionFormat-Option gleich XRSession.preferredReflectionFormat setzen.

js
const lightProbe = await xrSession.requestLightProbe({
  reflectionFormat: xrSession.preferredReflectionFormat,
});

Spezifikationen

Specification
WebXR Lighting Estimation API Level 1
# dom-xrsession-preferredreflectionformat

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch