XRFrame: getLightEstimate() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

XRFrame 介面的 getLightEstimate() 方法返回一個 XRLightEstimate 物件,其中包含給定 XRLightProbe 的估計光照值。

語法

js
getLightEstimate(lightProbe)

引數

lightProbe

一個 XRLightProbe 物件,包含當前幀的光照狀態。

返回值

如果裝置無法估計此幀的光照,則返回 XRLightEstimate 物件或 null

示例

獲取每一幀的光照估算

給定一個會話的 XRLightProbegetLightEstimate() 方法將獲取一個 XRLightEstimate 物件,其中包含每一幀的光照值。

js
const lightProbe = await xrSession.requestLightProbe();

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

  // Use light estimate data to light the scene

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

規範

規範
WebXR 光照估算 API Level 1
# dom-xrframe-getlightestimate

瀏覽器相容性

另見