Калибровка датчиков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 включает четыре значения, которые помогают определить, нуждается ли в калибровке устройство, на котором работает ваше приложение.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 минут.We recommend no more than once every 10 minutes.

ЗначениеValue ОписаниеDescription
UnknownUnknown Драйвер датчика не может сообщить текущую точность.The sensor driver could not report the current accuracy. Это необязательно означает, что устройство требует калибровки.This does not necessarily mean the device is out of calibration. Лучший порядок действий при возвращении значения Неизвестно определяется приложением.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.