XRLightEstimate: primaryLightDirection 属性

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

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

XRLightEstimate 接口的 只读 primaryLightDirection 属性返回一个 DOMPointReadOnly，表示来自 XRLightProbe 的 probeSpace 的主要光源方向。

值

一个 DOMPointReadOnly 对象。如果用户的环境中没有可用的估计值，则该点将为 { x: 0.0, y: 1.0, z: 0.0, w: 0.0 }，表示光线从上方直射下来。

示例

在 XRFrame 循环中，您可以使用 primaryLightDirection 和 primaryLightIntensity 属性根据最显眼的光源渲染阴影，例如。

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-primarylightdirection

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅