Accelerometer Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Devices.Sensors

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta un sensore dell'accelerometro.

Questo sensore restituisce valori di forza G rispetto agli assi x, y e z.

Per un'implementazione di esempio, vedere l'esempio di accelerometro.

public ref class Accelerometer sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Accelerometer final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Accelerometer

Public NotInheritable Class Accelerometer

Ereditarietà: Object Platform::Object IInspectable Accelerometer

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Le applicazioni usano i metodi in questa classe per determinare se la lettura del sensore è stata modificata o se il dispositivo è stato scosso.

Le applicazioni usano le proprietà di questa classe per recuperare e regolare l'intervallo del report del sensore.

I dati del sensore vengono forniti in relazione al sistema di coordinate del sensore fisso del dispositivo ed è indipendente dall'orientamento dello schermo. Per le applicazioni che si basano sui dati del sensore per il controllo di input o per modificare gli elementi sullo schermo, lo sviluppatore deve prendere in considerazione l'orientamento di visualizzazione corrente e compensare i dati in modo appropriato. Per altre info sul sistema di coordinate del sensore, vedi Dati del sensore e orientamento dello schermo.

L'esempio seguente illustra come un'app UWP compilata con XAML e C# usa il metodo GetDefault per stabilire una connessione a un accelerometro. Se non viene trovato alcun accelerometro integrato, il metodo restituirà un valore Null.

_accelerometer = Accelerometer.GetDefault();

L'esempio seguente illustra come un'app UWP compilata con XAML registra un gestore eventi ReadingChanged .

private void ScenarioEnable(object sender, RoutedEventArgs e)
{
    if (_accelerometer != null)
    {
        // Establish the report interval
        _accelerometer.ReportInterval = _desiredReportInterval;

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _accelerometer.ReadingChanged += new TypedEventHandler<Accelerometer, AccelerometerReadingChangedEventArgs>(ReadingChanged);

        ScenarioEnableButton.IsEnabled = false;
        ScenarioDisableButton.IsEnabled = true;
    }
    else
    {
        rootPage.NotifyUser("No accelerometer found", NotifyType.StatusMessage);
    }
}

Nell'esempio seguente viene illustrato il gestore eventi ReadingChanged .

async private void ReadingChanged(object sender, AccelerometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        AccelerometerReading reading = e.Reading;
        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);
    });
}

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	GetDefault(AccelerometerReadingType)
1607	14393	ReadingType
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
2004	19041	ReportThreshold

Proprietà

DeviceId	Ottiene l'identificatore del dispositivo.
MaxBatchSize	Ottiene il numero massimo di eventi che possono essere inseriti in batch dal sensore.
MinimumReportInterval	Ottiene l'intervallo minimo di report supportato dall'accelerometro.
ReadingTransform	Ottiene o imposta la trasformazione che deve essere applicata ai dati del sensore. Le trasformazioni da applicare sono associate all'orientamento dello schermo con cui allineare i dati del sensore.
ReadingType	Ottiene il tipo di sensore dell'accelerometro rappresentato da questo oggetto .
ReportInterval	Ottiene o imposta l'intervallo di report corrente per l'accelerometro.
ReportLatency	Ottiene o imposta il ritardo tra batch di informazioni sul sensore.
ReportThreshold	Ottiene l'oggetto AccelerometerDataThreshold per il sensore dell'accelerometro.

Metodi

FromIdAsync(String)	Ottiene in modo asincrono il sensore dal relativo identificatore.
GetCurrentReading()	Ottiene la lettura dell'accelerometro corrente.
GetDefault()	Restituisce l'accelerometro predefinito.
GetDefault(AccelerometerReadingType)	Restituisce l'accelerometro predefinito di un tipo specifico di sensore. I possibili sensori dell'accelerometro sono definiti da AccelerometerReadingType.
GetDeviceSelector(AccelerometerReadingType)	Ottiene il selettore del dispositivo.

Eventi

ReadingChanged	Si verifica ogni volta che l'accelerometro segnala una nuova lettura del sensore.
Shaken	Si verifica quando l'accelerometro rileva che il PC è stato scosso.

Si applica a

Condividi tramite