环境光传感器

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

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

AmbientLightSensor 是 传感器 API 的接口，它返回托管设备周围环境光的当前光照水平或照度。

要使用此传感器，用户必须通过 权限 API 授予对 'ambient-light-sensor' 设备传感器的权限。

此功能可能会被您服务器上设置的 权限策略 阻止。

EventTarget Sensor AmbientLightSensor

构造函数

AmbientLightSensor()

创建一个新的 AmbientLightSensor 对象。

实例属性

AmbientLightSensor.illuminance 只读

返回托管设备周围环境光照水平的当前光照水平，以 勒克斯 为单位。

实例方法

AmbientLightSensor 没有自己的方法。但是，它继承了父接口 Sensor 和 EventTarget 的方法。

事件

AmbientLightSensor 没有自己的事件。但是，它继承了父接口 Sensor 的事件。

示例

js
if ("AmbientLightSensor" in window) {
  const sensor = new AmbientLightSensor();
  sensor.addEventListener("reading", (event) => {
    console.log("Current light level:", sensor.illuminance);
  });
  sensor.addEventListener("error", (event) => {
    console.log(event.error.name, event.error.message);
  });
  sensor.start();
}

规范

规范
环境光传感器
# ambient-light-sensor-interface

浏览器兼容性

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