大网数据广告活动
Web 标准与前端开发

XRLightProbe

· 52CE 我爱测

The **`XRLightProbe`** interface of the WebXR Device API contains lighting information at a given point in the user's environment. You can get an `XRLighting` object using the XRSession.requestLightProbe() method.

WebXR Device API

The XRLightProbe interface of the WebXR Device API contains lighting information at a given point in the user's environment. You can get an XRLighting object using the XRSession.requestLightProbe() method.

This object doesn't itself contain lighting values, but it is used to collect lighting states for each XRFrame. See XRLightEstimate for the estimated lighting values for an XRLightProbe.

Instance properties

  • XRLightProbe.onreflectionchange
    • : Event handler property for the XRLightProbe.reflectionchange_event event.
  • XRLightProbe.probeSpace
    • : An XRSpace tracking the position and orientation the lighting estimations are relative to.

Instance methods

None.

Events

  • XRLightProbe.reflectionchange_event
    • : Fired each time the estimated reflection cube map changes. (This happens when the user moves around and the environment's lighting changes.)

Examples

Getting an XRLightProbe object for a session

Use the XRSession.requestLightProbe() method to get a light probe.

const lightProbe = await xrSession.requestLightProbe();

Getting a probe pose within an XRFrame

Pass the light probe's probeSpace to XRFrame.getPose() to get a light probe for a pose.

const probePose = xrFrame.getPose(lightProbe.probeSpace, xrReferenceSpace);

Using the reflectionchange event

Pass XRLightProbe to get a reflection cube map whenever the XRLightProbe.reflectionchange_event event fires. See also XRWebGLBinding.getReflectionCubeMap().

const glBinding = new XRWebGLBinding(xrSession, gl);
const lightProbe = await xrSession.requestLightProbe();
let glCubeMap = glBinding.getReflectionCubeMap(lightProbe);

lightProbe.addEventListener("reflectionchange", () => {
  glCubeMap = glBinding.getReflectionCubeMap(lightProbe);
});

Specifications

Browser compatibility

See also

  • XRSession.requestLightProbe()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。