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

浏览器兼容性

另见