AmbientLightSensor

Limited availability

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

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

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

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

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

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();
}