XRLightEstimate: sphericalHarmonicsCoefficients 属性

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

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，在某些或所有支持的浏览器中可用。

的只读sphericalHarmonicsCoefficients属性 XRLightEstimate 接口返回一个 Float32Array，其中包含 9 个球谐函数系数。

球谐函数照明是一种使用球面函数而不是标准照明方程的技术。有关更多信息，请参见维基百科。

值

一个 Float32Array，其中包含 9 个球谐函数系数。该数组总共包含 27 个元素，每 3 个元素定义每个系数的红色、绿色和蓝色分量。

前 3 个元素必须是有效的照明估计分量；由于隐私设置或设备提供更多数据的限制，其余元素可能为 0。

示例

在 XRFrame 循环中，您可以使用 sphericalHarmonicsCoefficients 属性来照亮场景。

const lightProbe = await xrSession.requestLightProbe();

// frame loop
function onXRFrame(time, xrFrame) {
  let lightEstimate = xrFrame.getLightEstimate(lightProbe);

  // Render lights using lightEstimate.sphericalHarmonicsCoefficients
}

规范

规范
WebXR 照明估计 API 级别 1 # dom-xrlightestimate-sphericalharmonicscoefficients

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅

XRFrame.getLightEstimate()