センサーの調整

磁力計 (コンパス、傾斜計、方位センサー) に基づくデバイス内のセンサーは、環境要因によって校正が必要な場合があります。 MagnetometerAccuracy 列挙は、デバイスで調整が必要なタイミングを判断するのに役立ちます。

重要な API

磁力計を校正するタイミング

MagnetometerAccuracy 列挙には、アプリが実行されているデバイスを調整する必要があるかどうかを判断するのに役立つ 4 つの値があります。 デバイスを調整する必要がある場合は、調整が必要であることをユーザーに知らせる必要があります。 ただし、ユーザーに対して、あまり頻繁に調整するように求めないようにしてください。 10 分に 1 回を超えないことをお勧めします。

価値 Description
不明 センサー ドライバーは、現在の精度を報告できませんでした。 これは、必ずしもデバイスがキャリブレーション外であることを意味するわけではありません。 Unknown が返された場合に最適なアクションのコースを決定するのは、アプリの判断です。 アプリが正確なセンサーの読み取りに依存している場合は、デバイスの調整をユーザーに求めるメッセージが表示されることがあります。
信頼できない 現在、磁力計に大きな誤差が生じています。 この値が最初に返されるときに、アプリは常にユーザーに調整を求める必要があります。
概数 データは、一部のアプリケーションで十分に正確です。 ユーザーがデバイスを上下または左/右に移動したかどうかを知る必要がある仮想現実アプリは、調整なしで続行できます。 ナビゲーション アプリのように、案内を行うためにユーザーがどの方向に運転しているかを把握する必要があるなど、絶対方位を必要とするアプリでは、キャリブレーションを求める必要があります。
高い データは正確です。 拡張現実やナビゲーション アプリなどの絶対的な見出しを知る必要があるアプリであっても、調整は必要ありません。