AmbientLightSensor

AmbientLightSensor interface of the the Sensor APIs returns the current light level or illuminance of the ambient light around the hosting device.

To use this sensor, the user must grant permission to the 'ambient-light-sensor' device sensor through the Permissions API.

If a feature policy blocks use of a feature it is because your code is inconsistent with the policies set on your server. This is not something that would ever be shown to a user. See Feature-Policy for implementation instructions.

构造函数

AmbientLightSensor.AmbientLightSensor()
创建新的 AmbientLightSensor 对象。

特性

AmbientLightSensor.illuminance
Returns the current light level in lux of the ambient light level around the hosting device.

范例

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

规范

规范 状态 Comment
Generic Sensor API 候选推荐 Defines sensors in general.
Ambient Light Sensor
The definition of 'AmbientLightSensor' in that specification.
候选推荐

浏览器兼容性

更新 GitHub 上的兼容性数据
Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
AmbientLightSensor Chrome 54
54
69
Based on Generic Sensor API.
Edge ≤79 Firefox No IE No Opera 56 Safari No WebView Android 54
54
69
Based on Generic Sensor API.
Chrome Android 54
54
69
Based on Generic Sensor API.
Firefox Android No Opera Android 48 Safari iOS No Samsung Internet Android 6.0
6.0
10.0
Based on Generic Sensor API.
AmbientLightSensor() 构造函数 Chrome 54
54
69
Based on Generic Sensor API.
Edge ≤79 Firefox No IE No Opera 56 Safari No WebView Android 54
54
69
Based on Generic Sensor API.
Chrome Android 54
54
69
Based on Generic Sensor API.
Firefox Android No Opera Android 48 Safari iOS No Samsung Internet Android 6.0
6.0
10.0
Based on Generic Sensor API.
illuminance Chrome 54
54
69
Based on Generic Sensor API.
79
Stopped returning floats and returned integers avoid fingerprinting.
Edge ≤79 Firefox No IE No Opera 56 Safari No WebView Android 54
54
69
Based on Generic Sensor API.
79
Stopped returning floats and returned integers avoid fingerprinting.
Chrome Android 54
54
69
Based on Generic Sensor API.
79
Stopped returning floats and returned integers avoid fingerprinting.
Firefox Android No Opera Android 48 Safari iOS No Samsung Internet Android 6.0
6.0
10.0
Based on Generic Sensor API.

图例

完整支持
完整支持
不支持
不支持
见实现注意事项。