传感器

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在某些或所有支持的浏览器中。

传感器 APISensor 接口是所有其他传感器接口的基类。此接口不能直接使用。相反,它提供了可被继承自它的接口访问的属性、事件处理程序和方法。

此功能可能会被服务器上设置的权限策略阻止。

EventTarget Sensor

最初创建时,Sensor 对象处于空闲状态,这意味着它不会进行测量。一旦调用了start() 方法,它就会准备好读取数据,并在准备好后发送activate 事件,传感器进入激活状态。然后,它会在每次有新数据可用时发送reading 事件。

如果发生错误,则会发送error 事件,读取停止,Sensor 对象再次变为空闲状态。在它可以进一步读取数据之前,需要再次调用start() 方法。

基于 Sensor 的接口

实例属性

Sensor.activated 只读

返回一个布尔值,指示传感器是否处于活动状态。

Sensor.hasReading 只读

返回一个布尔值,指示传感器是否有读数。

Sensor.timestamp 只读

返回最新传感器读数的时间戳。

实例方法

Sensor.start()

激活基于 Sensor 的其中一个传感器。

Sensor.stop()

停用基于 Sensor 的其中一个传感器。

事件

activate

当传感器被激活时触发。

error

当传感器发生异常时触发。

reading

当传感器有新的读数可用时触发。

规范

规范
通用传感器 API
# the-sensor-interface

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。