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

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
AmbientLightSensor
Experimental
AmbientLightSensor() constructor
Experimental
illuminance
Experimental

Legend

Tip: you can click/tap on a cell for more information.

No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.
Has more compatibility info.