Calibrar sensoresCalibrate sensors

APIs importantesImportant APIs

Sensores em um dispositivo baseado no magnetômetro (bússola, inclinômetro e sensor de orientação) podem precisar de calibragem devido a fatores ambientais.Sensors in a device based on the magnetometer – the compass, inclinometer and orientation sensor - can become in need of calibration due to environmental factors. A enumeração MagnetometerAccuracy pode ajudar a determinar um curso de ação quando seu dispositivo precisar de calibração.The MagnetometerAccuracy enumeration can help determine a course of action when your device is in need of calibration.

Quando calibrar o magnetômetroWhen to calibrate the magnetometer

A enumeração MagnetometerAccuracy tem quatro valores que ajudam a determinar se o dispositivo no qual o seu aplicativo está em execução precisa ser calibrado.The MagnetometerAccuracy enumeration has four values that help you determine if the device your app is running on needs to be calibrated. Se um dispositivo precisar ser calibrado, você deve informar ao usuário que uma calibragem é necessária.If a device needs to be calibrated, you should let the user know that calibration is needed. No entanto, você não deve enviar prompts de calibragem com muita frequência para o usuário.However, you should not prompt the user to calibrate too frequently. Recomendamos não mais do que uma vez a cada 10 minutos.We recommend no more than once every 10 minutes.

ValorValue DescriçãoDescription
DesconhecidoUnknown O driver do sensor não pôde relatar a precisão atual.The sensor driver could not report the current accuracy. Isso não significa necessariamente que o dispositivo está descalibrado.This does not necessarily mean the device is out of calibration. Cabe ao seu aplicativo decidir o melhor curso de ação se o valor Desconhcido for retornado.It is up to your app to decide the best course of action if Unknown is returned. Se o seu aplicativo depender de uma leitura de sensor precisa, convém enviar um prompt para o usuário calibrar o dispositivo.If your app is dependant on an accurate sensor reading, you may want to prompt the user to calibrate the device.
Não confiávelUnreliable Atualmente, há um alto grau de imprecisão no magnetômetro.There is currently a high degree of inaccuracy in the magnetometer. Os aplicativos sempre devem solicitar uma calibragem ao usuário da primeira vez em que esse valor é retornado.Apps should always ask for a calibration from the user when this value is first returned.
AproximadoApproximate Os dados são precisos o suficiente para alguns aplicativos.The data is accurate enough for some applications. Um aplicativo de realidade aplicativo, que só precisa saber se o usuário movimento o dispositivo para cima/baixo ou para a esquerda/direita, pode continuar sem calibragem.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. Aplicativos que exigem uma posição absoluta, como um aplicativo de navegação que precisa saber em que direção você está indo para poder fornecer instruções, precisam solicitar uma calibragem.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 Os dados são precisos.The data is precise. Nenhuma calibragem é necessária, mesmo para aplicativos que precisam conhecer uma posição absoluta, como aplicativos de navegação ou realidade ampliada.No calibration is needed, even for apps that need to know an absolute heading such as augmented reality or navigation apps.