您正位於 MDN Web Docs 的可編輯版本

以 MDN Web Docs 使用者身分檢視: https://developer.mozilla.org/zh-TW/docs/Web/API/Magnetometer

我們的志工尚未將本文翻譯為 正體中文 (繁體) 版本。加入我們,幫忙翻譯!
您也可以閱讀本文的 English (US) 版本。

The Magnetometer interface of the Sensor APIs provides information about the magnetic field as detected by the device’s primary magnetometer sensor.

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

If a feature policy blocks use of a feature, it's 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.

Constructor

Magnetometer.Magnetometer()
Creates a new Magnetometer object.

Properties

Magnetometer.x Read only
Returns a double containing the magnetic field around the device's x axis.
Magnetometer.y Read only
Returns a double containing the magnetic field around the device's y axis.
Magnetometer.z Read only
Returns a double containing the magnetic field around the device's z axis.

Example

The magnetometer is typically read in the Sensor.onreading event callback. In the example below this occurs sixty times a second.

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();

Specifications

Specification Status Comment
Generic Sensor API Candidate Recommendation Defines sensors in general.
Magnetometer
The definition of 'Magnetometer' in that specification.
Candidate Recommendation  

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
MagnetometerChrome Full support 56
Disabled
Full support 56
Disabled
Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.
Edge Full support 79
Disabled
Full support 79
Disabled
Disabled From version 79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to Enabled).
Firefox No support NoIE No support NoOpera Full support 43
Disabled
Full support 43
Disabled
Disabled From version 43: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to Enabled).
Safari No support NoWebView Android No support NoChrome Android Full support 56
Disabled
Full support 56
Disabled
Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android No support NoOpera Android Full support 43
Disabled
Full support 43
Disabled
Disabled From version 43: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to Enabled).
Safari iOS No support NoSamsung Internet Android No support No
Magnetometer() constructorChrome Full support 56Edge Full support 79Firefox No support NoIE No support NoOpera Full support 43Safari No support NoWebView Android No support NoChrome Android Full support 56Firefox Android No support NoOpera Android Full support 43Safari iOS No support NoSamsung Internet Android No support No
xChrome Full support 56Edge Full support 79Firefox No support NoIE No support NoOpera Full support 43Safari No support NoWebView Android No support NoChrome Android Full support 56Firefox Android No support NoOpera Android Full support 43Safari iOS No support NoSamsung Internet Android No support No
yChrome Full support 56Edge Full support 79Firefox No support NoIE No support NoOpera Full support 43Safari No support NoWebView Android No support NoChrome Android Full support 56Firefox Android No support NoOpera Android Full support 43Safari iOS No support NoSamsung Internet Android No support No
zChrome Full support 56Edge Full support 79Firefox No support NoIE No support NoOpera Full support 43Safari No support NoWebView Android No support NoChrome Android Full support 56Firefox Android No support NoOpera Android Full support 43Safari iOS No support NoSamsung Internet Android No support No

Legend

Full support  
Full support
No support  
No support
User must explicitly enable this feature.
User must explicitly enable this feature.

文件標籤與貢獻者

此頁面的貢獻者: Wuzzel, mdnwebdocs-bot, jpmedley
最近更新: Wuzzel,