AmbientLightSensor

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

Sensor APIs の AmbientLightSensor インターフェイスは、現在の光レベル、すなわちホストデバイス周辺の環境光の照度を返します。

このセンサーを使用するには、ユーザーが Permissions API により 'ambient-light-sensor' デバイスセンサーを使用する許可を与える必要があります。

この機能はサーバーで設定された Permissions Policy でブロックされる可能性があります。

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

ブラウザーの互換性

BCD tables only load in the browser