XRSession: preferredReflectionFormat 属性

实验性: 这是一项实验性技术
在生产环境中使用此功能之前,请仔细查看浏览器兼容性表

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,部分或全部支持的浏览器

只读 preferredReflectionFormat 属性是 XRSession 接口的属性,它返回此会话用于光照估算纹理数据的首选反射格式。

表示反射格式的字符串。可能的取值

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

示例

请求具有系统首选格式的光探测器

您可以使用XRSession.requestLightProbe() 请求一个光探测器,并将 reflectionFormat 选项设置为 XRSession.preferredReflectionFormat 来指定系统的首选格式。

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

规范

规范
WebXR 光照估算 API 1 级
# dom-xrsession-preferredreflectionformat

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅