磁力計

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

Sensor APIs 介面中的 Magnetometer 介面提供有關裝置主磁力計感測器所檢測到的磁場的資訊。

要使用此感測器,使用者必須透過 Permissions API 授予對 'magnetometer' 裝置感測器的許可權。此外,此功能可能會被伺服器上設定的 Permissions Policy 阻止。

EventTarget Sensor Magnetometer

建構函式

Magnetometer() 實驗性

建立一個新的 Magnetometer 物件。

例項屬性

Magnetometer.x 只讀 實驗性

返回一個雙精度浮點數,表示裝置 x 軸周圍的磁場。

Magnetometer.y 只讀 實驗性

返回一個雙精度浮點數,表示裝置 y 軸周圍的磁場。

Magnetometer.z 只讀 實驗性

返回一個雙精度浮點數,表示裝置 z 軸周圍的磁場。

例項方法

Magnetometer 沒有自己的方法。但是,它繼承了其父介面 SensorEventTarget 的方法。

事件

Magnetometer 沒有自己的事件。但是,它繼承了其父介面 Sensor 的事件。

示例

通常在 reading 事件回撥中讀取磁力計。在下面的示例中,這每秒發生六十次。

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

瀏覽器相容性