Limited support 一部のブラウザのみ対応。使用時はサポート状況を確認すること。

Ambient light sensor

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

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

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

EventTarget Sensor AmbientLightSensor

デバイス・センサー

対応ブラウザ

機能	デスクトップ				モバイル
機能	Chrome	Edge	Firefox	Safari	Chrome Android	Safari iOS
`AmbientLightSensor` 実験的	67	79			67
HTML 属性
`allow (ambient-light-sensor)` 実験的	66	79			66
DOM API
`AmbientLightSensor` 実験的 AmbientLightSensor() コンストラクターは、現在の光レベル、すなわちホストデバイス周辺の環境光の照度を返す新しい AmbientLightSensor オブジェクトを生成します。	67	79			67
`illuminance` 実験的 AmbientLightSensor インターフェイスの illuminance プロパティは、ホストデバイス周辺の環境光のルクス単位のレベルを、現在の光レベルとして返します。	67	79			67
`permission_ambient-light-sensor` 実験的環境光センサー`の許可	62	79			62
その他
`ambient-light-sensor` 実験的 HTTP の Permissions-Policy ヘッダーにおける ambient-light-sensor ディレクティブは、現在の文書が AmbientLightSensor インターフェイスを通じて端末の周囲の環境における明るさの量に関する情報を収集することを許可するかどうかを制御します。	66	79			66

1+対応 (バージョン) 未対応 ※注釈ありサブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

基本構文

JAVASCRIPT

if ("AmbientLightSensor" in window) {
  const sensor = new AmbientLightSensor();
  sensor.addEventListener("reading", (event) => {
    console.log("Current light level:", sensor.illuminance);
  });
  sensor.addEventListener("error", (event) => {
    console.log(event.error.name, event.error.message);
  });
  sensor.start();
}

実務での使いどころ

Ambient light sensor の活用

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

注意点

一部のブラウザでのみ対応。使用前にブラウザサポートを確認すること。

実装メモ

一部の API はセキュアコンテキスト (HTTPS) やユーザー操作起点を必要とする。利用前に要件を確認すること。

対応ブラウザ

基本構文

実務での使いどころ

Ambient light sensor の活用

注意点

実装メモ

参考リンク