Calibrare i sensoriCalibrate sensors

API importantiImportant APIs

In determinate condizioni ambientali è necessario calibrare i dispositivi basati sul magnetometro (bussola, inclinometro e sensore di orientamento).Sensors in a device based on the magnetometer – the compass, inclinometer and orientation sensor - can become in need of calibration due to environmental factors. L'enumerazione MagnetometerAccuracy può essere utile per determinare l'azione da eseguire quando devi calibrare il dispositivo.The MagnetometerAccuracy enumeration can help determine a course of action when your device is in need of calibration.

Quando calibrare il magnetometroWhen to calibrate the magnetometer

L'enumerazione MagnetometerAccuracy ha quattro valori che consentono di determinare se il dispositivo in cui è in esecuzione l'app deve essere calibrato.The MagnetometerAccuracy enumeration has four values that help you determine if the device your app is running on needs to be calibrated. Se un dispositivo deve essere calibrato, devi comunicare all'utente che è necessario eseguire la calibrazione.If a device needs to be calibrated, you should let the user know that calibration is needed. Tuttavia, non è consigliabile chiedere all'utente di eseguire la calibrazione troppo spesso.However, you should not prompt the user to calibrate too frequently. Ti suggeriamo di non eseguirla più di una volta ogni 10 minuti.We recommend no more than once every 10 minutes.

ValoreValue DescrizioneDescription
UnknownUnknown Il driver del sensore non è stato in grado di segnalare l'accuratezza corrente.The sensor driver could not report the current accuracy. Questo non significa necessariamente che il dispositivo non è calibrato.This does not necessarily mean the device is out of calibration. Se viene restituito Unknown, sarà l’app a dover determinare l’azione migliore.It is up to your app to decide the best course of action if Unknown is returned. Se l'app dipende da una lettura precisa del sensore, potresti voler chiedere all'utente di calibrare il dispositivo.If your app is dependant on an accurate sensor reading, you may want to prompt the user to calibrate the device.
Non affidabileUnreliable In magnetometro è attualmente presente un elevato livello di inesattezza.There is currently a high degree of inaccuracy in the magnetometer. La prima volta che viene restituito questo valore, le app devono sempre chiedere all'utente di eseguire la calibrazione.Apps should always ask for a calibration from the user when this value is first returned.
Con approssimazioneApproximate I dati sono sufficientemente accurati per alcune applicazioni.The data is accurate enough for some applications. Un'app di realtà virtuale, che deve solo stabilire se l'utente ha spostato il dispositivo verso l'alto o il basso oppure verso sinistra o destra, può continuare anche senza calibrazione.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. Le app che hanno bisogno di informazioni estremamente precise, come un'app di navigazione che deve identificare la direzione in cui procedi per fornire indicazioni stradali, devono invece richiedere la calibrazione.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 I dati sono precisi.The data is precise. La calibrazione non è necessaria, nemmeno per le app che hanno bisogno di informazioni estremamente precise, come le app di realtà aumentata o di navigazione.No calibration is needed, even for apps that need to know an absolute heading such as augmented reality or navigation apps.