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

Ambient light sensor

Experimental: これは実験的な機能です。

本番で使用する前にブラウザー互換性一覧表をチェックしてください。

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

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

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

EventTarget Sensor AmbientLightSensor

デバイスAPI

対応ブラウザ

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

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

基本構文

JAVASCRIPT

const sensor = new AmbientLightSensor();
sensor.addEventListener('reading', () => {
  console.log('Illuminance:', sensor.illuminance, 'lux');
});
sensor.start();

実務での使いどころ

Ambient light sensor の活用

Experimental: これは実験的な機能です。

注意点

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

対応ブラウザ

基本構文

実務での使いどころ

Ambient light sensor の活用

注意点

アクセシビリティ

参考リンク