センサーの調整Calibrate sensors

重要な APIImportant APIs

デバイスの磁力計 (コンパス、傾斜計、方位センサー) に基づくセンサーは、環境の要因に応じて調整が必要になることがあります。Sensors in a device based on the magnetometer – the compass, inclinometer and orientation sensor - can become in need of calibration due to environmental factors. MagnetometerAccuracy 列挙値は、デバイスの調整が必要になる場合の対応策を決めるのに役立ちます。The MagnetometerAccuracy enumeration can help determine a course of action when your device is in need of calibration.

磁力計を調整するタイミングWhen to calibrate the magnetometer

MagnetometerAccuracy 列挙値には、アプリが実行されているデバイスを調整する必要があるかどうかを判断するのに役立つ 4 つの値があります。The MagnetometerAccuracy enumeration has four values that help you determine if the device your app is running on needs to be calibrated. デバイスを調整する必要がある場合は、その旨をユーザーに知らせる必要があります。If a device needs to be calibrated, you should let the user know that calibration is needed. ただし、あまりに頻繁に調整を行うようユーザーに促さないでください。However, you should not prompt the user to calibrate too frequently. 10 分に 1 回を超えないようにします。We recommend no more than once every 10 minutes.

ValueValue 説明Description
UnknownUnknown センサー ドライバーは現在の正確さを報告できませんでした。The sensor driver could not report the current accuracy. これは、必ずしもデバイスが調整されていないことを意味するわけではありません。This does not necessarily mean the device is out of calibration. Unknown が返された場合の最適な対応策は、開発しているアプリによって決まります。It is up to your app to decide the best course of action if Unknown is returned. アプリがセンサーの正確な読み取り値を利用しているのであれば、ユーザーにデバイスの調整を促します。If your app is dependant on an accurate sensor reading, you may want to prompt the user to calibrate the device.
信頼性の低いUnreliable 現在、磁力計の正確さが大きく劣っています。There is currently a high degree of inaccuracy in the magnetometer. この値が最初に返された時点で、アプリからユーザーに必ず調整を求めます。Apps should always ask for a calibration from the user when this value is first returned.
おおよそApproximate 特定のアプリに対してデータは十分に正確です。The data is accurate enough for some applications. ユーザーがデバイスを上下または左右に動かしたかどうかがわかればよいだけの仮想現実アプリでは、調整なしで続行できます。A virtual reality app, that only needs to know if the user has moved the device up/down or left/right, can continue without calibration. 指示を出すためにどの方向に進んでいるか知る必要があるナビゲーション アプリのように、絶対的な進路を必要とするアプリでは、調整を促す必要があります。Apps that need an absolute heading, like a navigation app that needs to know what direction you are driving in order to give you directions, need to ask for calibration.
High データは正確です。The data is precise. 拡張現実アプリ、ナビゲーション アプリなどの絶対的な進路を知る必要があるアプリでも、調整は必要ありません。No calibration is needed, even for apps that need to know an absolute heading such as augmented reality or navigation apps.