Accelerometer.GetCurrentReading Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém a leitura atual do acelerômetro.
public:
virtual AccelerometerReading ^ GetCurrentReading() = GetCurrentReading;
AccelerometerReading GetCurrentReading();
public AccelerometerReading GetCurrentReading();
function getCurrentReading()
Public Function GetCurrentReading () As AccelerometerReading
Retornos
Esse método não tem parâmetros.
Exemplos
O exemplo a seguir demonstra como um aplicativo UWP criado com XAML e C# recupera a leitura atual para os três eixos do acelerômetro padrão.
private void DisplayCurrentReading(object sender, object args)
{
AccelerometerReading reading = _accelerometer.GetCurrentReading();
if (reading != null)
{
ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.AccelerationX);
ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.AccelerationY);
ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.AccelerationZ);
}
}
Comentários
Um aplicativo pode usar esse método para sondar o sensor para a leitura atual como uma alternativa para registrar um manipulador de eventos ReadingChanged . Essa seria a alternativa preferencial para um aplicativo que atualiza sua interface do usuário a uma taxa de quadros específica. Seja sondando uma ou muitas vezes, o aplicativo deve estabelecer um ReportInterval desejado. Isso informa ao driver do sensor que os recursos devem ser alocados para atender às solicitações de sondagem subsequentes
Se o sensor estiver configurado para dar suporte à entrega em lote, esse método liberará o lote atual e iniciará um novo período de latência. Para obter mais informações sobre o envio em lote do sensor, consulte Sensores.
Antes de usar o valor retornado desse método, o aplicativo deve primeiro marcar que o valor não é nulo. (Se o valor for nulo e você tentar recuperá-lo, o Windows gerará uma exceção.)