環境光感測器

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(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

瀏覽器相容性