Limited support 一部のブラウザのみ対応。使用時はサポート状況を確認すること。

Magnetometer

Sensor APIs の Magnetometer インターフェイスは、デバイスのプライマリー磁気センサーで検出される磁場の情報を提供します。

このセンサーを使用するには、ユーザーが権限 API により 'magnetometer' デバイスセンサーを使用する許可を与える必要があります。さらに、この機能はサーバーで設定された権限ポリシーでブロックされる可能性があります。

EventTarget Sensor Magnetometer

デバイス・センサー

対応ブラウザ

機能	デスクトップ				モバイル
機能	Chrome	Edge	Firefox	Safari	Chrome Android	Safari iOS
`Magnetometer` 実験的	56	79			56
HTML 属性
`allow (magnetometer)` 実験的	66	79			66
DOM API
`Magnetometer` 実験的 Magnetometer() コンストラクターは、デバイスのプライマリー磁気センサーで検出される磁場の情報を返す新しい Magnetometer オブジェクトを生成します。	56	79			56
`x` 実験的 Magnetometer インターフェイスの読み取り専用プロパティ x は、デバイスの x 軸方向の磁場を表す数値を返します。	56	79			56
`y` 実験的 Magnetometer インターフェイスの読み取り専用プロパティ y は、デバイスの y 軸方向の磁場を表す数値を返します。	56	79			56
`z` 実験的 Magnetometer インターフェイスの読み取り専用プロパティ z は、デバイスの z 軸方向の磁場を表す数値を返します。	56	79			56
`permission_magnetometer` 実験的磁力計`の許可	62	79			62
その他
`magnetometer` 実験的 HTTP の Permissions-Policy ヘッダーにおける magnetometer ディレクティブは、現在の文書が端末の方向についての情報を Magnetometer インターフェイスで収集することを許可するかどうかを制御します。	66	79			66

1+対応 (バージョン) 未対応 ※注釈ありサブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

基本構文

JAVASCRIPT

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 の活用

Sensor APIs の Magnetometer インターフェイスは、デバイスのプライマリー磁気センサーで検出される磁場の情報を提供します。

注意点

一部のブラウザでのみ対応。使用前にブラウザサポートを確認すること。

実装メモ

一部の API はセキュアコンテキスト (HTTPS) やユーザー操作起点を必要とする。利用前に要件を確認すること。

対応ブラウザ

基本構文

実務での使いどころ

Magnetometer の活用

注意点

実装メモ

参考リンク