Calibrar los sensoresCalibrate sensors

API importantesImportant APIs

Es probable que sea necesario calibrar los sensores basados en el magnetómetro de un dispositivo, es decir, la brújula, el inclinómetro y el sensor de orientación, debido a factores ambientales.Sensors in a device based on the magnetometer – the compass, inclinometer and orientation sensor - can become in need of calibration due to environmental factors. La enumeración MagnetometerAccuracy puede ayudar a determinar un curso de acción cuando el dispositivo necesite calibración.The MagnetometerAccuracy enumeration can help determine a course of action when your device is in need of calibration.

Cuándo se debe calibrar el magnetómetroWhen to calibrate the magnetometer

La enumeración MagnetometerAccuracy tiene cuatro valores que sirven para determinar si el dispositivo donde se ejecuta tu aplicación necesita calibración.The MagnetometerAccuracy enumeration has four values that help you determine if the device your app is running on needs to be calibrated. Si este es el caso, debes permitir que el usuario sepa que se necesita calibración.If a device needs to be calibrated, you should let the user know that calibration is needed. Pero no debes solicitarla con demasiada frecuencia.However, you should not prompt the user to calibrate too frequently. Recomendamos que el usuario reciba una solicitud de calibración cada 10 minutos como máximo.We recommend no more than once every 10 minutes.

ValueValue DescripciónDescription
UnknownUnknown El controlador del sensor no pudo notificar la precisión actual.The sensor driver could not report the current accuracy. Esto no necesariamente significa que el dispositivo no esté calibrado.This does not necessarily mean the device is out of calibration. Será la aplicación la que decida el mejor curso de acción si se devuelve el valor Unknown.It is up to your app to decide the best course of action if Unknown is returned. Si la aplicación depende de una lectura de sensor precisa, quizás quieras solicitarle al usuario que calibre el dispositivo.If your app is dependant on an accurate sensor reading, you may want to prompt the user to calibrate the device.
Poco confiablesUnreliable Actualmente hay un alto grado de inexactitud en el magnetómetro.There is currently a high degree of inaccuracy in the magnetometer. La aplicación siempre debe solicitar la calibración por parte del usuario cuando este valor se devuelve primero.Apps should always ask for a calibration from the user when this value is first returned.
AproximadoApproximate Los datos son lo suficientemente precisos para algunas aplicaciones.The data is accurate enough for some applications. Una aplicación de realidad virtual puede continuar sin calibración cuando solo necesita saber si el usuario movió el dispositivo hacia arriba o abajo, o hacia la derecha o izquierda.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. Las aplicaciones que necesitan un encabezado absoluto; por ejemplo, una aplicación que debe saber hacia dónde te estás moviendo para poder dar direcciones, necesitan pedir la calibración.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.
AltaHigh Los datos son precisos.The data is precise. No se necesita calibración, ni siquiera para las aplicaciones que deben conocer un encabezado absoluto como, por ejemplo, las aplicaciones de navegación o de realidad aumentada.No calibration is needed, even for apps that need to know an absolute heading such as augmented reality or navigation apps.