环境光传感器

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

AmbientLightSensor 接口属于 传感器 API,用于返回托管设备周围环境光的当前光照水平或照度。

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

此功能可能会被您服务器上设置的 Permissions Policy 阻止。

EventTarget Sensor AmbientLightSensor

构造函数

AmbientLightSensor() 实验性的

创建一个新的 AmbientLightSensor 对象。

实例属性

AmbientLightSensor.illuminance 只读 实验性的

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

实例方法

AmbientLightSensor 没有自己的方法。但是,它继承了其父接口 SensorEventTarget 的方法。

事件

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

浏览器兼容性