XRSession: preferredReflectionFormat 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

XRSession 介面的只讀 preferredReflectionFormat 屬性返回此會話用於光照估計紋理資料的首選反射格式。

一個表示反射格式的字串。可能的值

XRReflectionFormat WebGL 格式 WebGL 內部格式 WebGPU 格式 HDR
"srgba8" RGBA SRGB8_ALPHA8 "rgba8unorm-srgb"
"rgba16f" RGBA RGBA16F "rgba16float"

示例

使用系統首選格式請求光照探測器

您可以透過將 reflectionFormat 選項設定為 XRSession.preferredReflectionFormat 來使用 XRSession.requestLightProbe() 請求光照探測器,並指定系統的首選格式。

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

規範

規範
WebXR 光照估算 API Level 1
# dom-xrsession-preferredreflectionformat

瀏覽器相容性

另見