AmbientLightSensor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全上下文: 此项功能仅在一些支持的浏览器的安全上下文（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("当前光照强度值：", sensor.illuminance);
  });
  sensor.addEventListener("error", (event) => {
    console.log(event.error.name, event.error.message);
  });
  sensor.start();
}

规范

Specification
Ambient Light Sensor
# ambient-light-sensor-interface

浏览器兼容性