磁力计

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

实验性:这是一个实验性技术
在生产环境中使用此功能之前,请仔细查看浏览器兼容性表

Magnetometer 接口是传感器 API的一部分,它提供有关设备的主磁力计传感器检测到的磁场的信息。

要使用此传感器,用户必须通过权限 API授予对 'magnetometer' 设备传感器的权限。此外,此功能可能会被服务器上设置的权限策略阻止。

EventTarget Sensor Magnetometer

构造函数

Magnetometer() 实验性

创建一个新的 Magnetometer 对象。

实例属性

Magnetometer.x 只读 实验性

返回一个包含设备 x 轴周围磁场的双精度浮点数。

Magnetometer.y 只读 实验性

返回一个包含设备 y 轴周围磁场的双精度浮点数。

Magnetometer.z 只读 实验性

返回一个包含设备 z 轴周围磁场的双精度浮点数。

实例方法

Magnetometer 没有自己的方法。但是,它继承了其父接口 SensorEventTarget 的方法。

事件

Magnetometer 没有自己的事件。但是,它继承了其父接口 Sensor 的事件。

示例

磁力计通常在reading 事件回调中读取。在下面的示例中,每秒发生 60 次。

js
let magSensor = new Magnetometer({ frequency: 60 });

magSensor.addEventListener("reading", (e) => {
  console.log(`Magnetic field along the X-axis ${magSensor.x}`);
  console.log(`Magnetic field along the Y-axis ${magSensor.y}`);
  console.log(`Magnetic field along the Z-axis ${magSensor.z}`);
});
magSensor.start();

规范

规范
磁力计
# magnetometer-interface

浏览器兼容性

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