AmbientLightSensor
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
Sensor APIs の AmbientLightSensor インターフェイスは、現在の光レベル、すなわちホストデバイス周辺の環境光の照度を返します。
このセンサーを使用するには、ユーザーが 権限 API により 'ambient-light-sensor' デバイスセンサーを使用する許可を与える必要があります。
この機能はサーバーで設定された 権限ポリシー でブロックされる可能性があります。
コンストラクター
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();
}
仕様書
| 仕様書 |
|---|
| Ambient Light Sensor # ambient-light-sensor-interface |