AmbientLightSensor

Limited availability

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

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

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

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

この機能はサーバーで設定された 権限ポリシー でブロックされる可能性があります。

EventTarget Sensor AmbientLightSensor

コンストラクター

AmbientLightSensor() Experimental

新しい AmbientLightSensor オブジェクトを生成します。

インスタンスプロパティ

AmbientLightSensor.illuminance Experimental

ホストデバイス周辺の環境光のルクス単位のレベルを、現在の光レベルとして返します。

インスタンスメソッド

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