XRLightEstimate:primaryLightIntensity 属性

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

安全上下文: 此功能仅在 安全上下文(HTTPS)中可用,某些或所有 支持的浏览器中。

XRLightEstimate 接口的只读primaryLightIntensity属性返回一个 DOMPointReadOnly,表示来自 XRLightProbeprobeSpace的主要光源的强度。

一个 DOMPointReadOnly 对象,其中 RGB 值映射到xyz值。w值始终为1.0。如果用户环境中没有可用的估计值,则该点将为{x: 0.0, y: 0.0, z: 0.0, w: 1.0},表示没有照明。

示例

例如,在 XRFrame循环中,您可以使用primaryLightDirectionprimaryLightIntensity属性根据最突出的光源渲染阴影。

js
const lightProbe = await xrSession.requestLightProbe();

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

  // Render lights

  // Available properties
  lightEstimate.primaryLightDirection;
  lightEstimate.primaryLightIntensity;
}

规范

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

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅