XRSession: requestLightProbe() 方法

options 可选

包含配置选项的对象，具体来说

reflectionFormat

指示纹理数据如何表示的内部反射格式，可以是 srgba8（默认值）或 rgba16f。另请参阅 XRSession.preferredReflectionFormat.

一个 Promise，它解析为一个 XRLightProbe 对象。

requestLightProbe() 不会抛出真正的异常，而是用一个 DOMException 拒绝返回的承诺，具体来说，是以下情况之一

NotSupportedError DOMException

如果 lighting-estimation 不是 XRSystem.requestSession() 中启用的功能，或者 reflectionFormat 不是 srgb8 或 preferredReflectionFormat，则抛出此异常。

InvalidStateError DOMException

如果会话已结束，则抛出此异常。

默认格式为srgb8，但是，某些渲染引擎可能会使用其他（高动态范围）格式。您可以使用XRSession.preferredReflectionFormat请求光探针，它会报告首选的内部格式。

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

• XRSession.preferredReflectionFormat