AmbientLightSensor: AmbientLightSensor() コンストラクター

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

AmbientLightSensor() コンストラクターは、現在の光レベル、すなわちホストデバイス周辺の環境光の照度を返す新しい AmbientLightSensor オブジェクトを生成します。

構文

js
new AmbientLightSensor()
new AmbientLightSensor(options)

引数

options 省略可

現在、1 個のオプションのみに対応しています。

frequency

1 秒間にサンプルを何回取得したいかであり、reading イベントが呼ばれる 1 秒あたりの回数になります。整数または小数が使用でき、小数は 1 秒に 1 回未満の頻度を設定するのに用います。実際の取得頻度はデバイスハードウェアに依存するので、要求値より少なくなる可能性があります。

例外

SecurityError DOMException

この機能の使用が Permissions Policy によりブロックされまし

仕様書

Specification
Ambient Light Sensor
# dom-ambientlightsensor-ambientlightsensor

ブラウザーの互換性

BCD tables only load in the browser

関連情報