此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

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 本身不包含专有方法,但会继承其父接口 SensorEventTarget 的方法。

事件

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

浏览器兼容性