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 Level 1
# dom-xrlightestimate-primarylightintensity

瀏覽器相容性

另見