Inclinometer Klasse

Definition

Namespace:

Windows.Devices.Sensors

Stellt einen Neigungsmessersensor dar, der Neigungs-, Roll- und Gierwerte bereitstellt, die den Drehwinkeln um die x-, y- und z-Achse entsprechen.

public ref class Inclinometer 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 Inclinometer 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 Inclinometer

Public NotInheritable Class Inclinometer

Vererbung

Object Platform::Object IInspectable Inclinometer

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Eine Beispielimplementierung finden Sie im Neigungsmesserbeispiel https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/Inclinometer.

Hinweise

Sensordaten werden relativ zum festen Sensorkoordinatensystem des Geräts bereitgestellt und sind unabhängig von der Anzeigeausrichtung. Bei Anwendungen, die Sensordaten zur Eingabesteuerung oder zum Bearbeiten von Elementen auf dem Bildschirm benötigen, muss der Entwickler die aktuelle Anzeigeausrichtung berücksichtigen und die Daten entsprechend kompensieren. Weitere Informationen zum Sensorkoordinatensystem finden Sie unter Sensordaten und Anzeigeausrichtung.

Im folgenden Beispiel wird veranschaulicht, wie eine mit XAML und C# erstellte UWP-App die GetDefault-Methode verwendet, um eine Verbindung mit einem Neigungsmesser herzustellen. Wenn kein integrierter Neigungsmesser gefunden wird, gibt die Methode einen NULL-Wert zurück.

_inclinometer = Inclinometer.GetDefault();

Im folgenden Beispiel wird veranschaulicht, wie eine mit XAML erstellte UWP-App einen ReadingChanged-Ereignishandler registriert.

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

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _inclinometer.ReadingChanged += new TypedEventHandler<Inclinometer, InclinometerReadingChangedEventArgs>(ReadingChanged);

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

Das folgende Beispiel zeigt den ReadingChanged-Ereignishandler .

async private void ReadingChanged(object sender, InclinometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        InclinometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.PitchDegrees);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.RollDegrees);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.YawDegrees);
    });
}

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	GetDefault(SensorReadingType)
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
1709	16299	MaxBatchSize
1709	16299	ReportLatency
2004	19041	ReportThreshold

Eigenschaften

DeviceId	Ruft den Gerätebezeichner ab.
MaxBatchSize	Ruft die maximale Anzahl von Ereignissen ab, die vom Sensor in einem Batch verarbeitet werden können.
MinimumReportInterval	Ruft das minimale Berichtsintervall ab, das vom Neigungsmesser unterstützt wird.
ReadingTransform	Ruft die Transformation ab, die auf Sensordaten angewendet werden muss, oder legt diese fest. Die anzuwendenden Transformationen sind an die Anzeigeausrichtung gebunden, an der die Sensordaten ausgerichtet werden sollen.
ReadingType	Ruft den Lesetyp des Sensors ab.
ReportInterval	Ruft das aktuelle Berichtsintervall für den Neigungsmesser ab oder legt es fest.
ReportLatency	Ruft die Verzögerung zwischen Batches von Sensorinformationen ab oder legt sie fest.
ReportThreshold	Ruft den InclinometerDataThreshold für den Gyrometersensor ab.

Methoden

FromIdAsync(String)	Ruft den Sensor asynchron aus seinem Bezeichner ab.
GetCurrentReading()	Ruft den aktuellen Neigungsmesserwert ab.
GetDefault()	Gibt den Standardneigungsmesser für absolute Werte zurück.
GetDefault(SensorReadingType)	Gibt den Standardneigungsmesser basierend auf dem SensorReadingType zurück.
GetDefaultForRelativeReadings()	Gibt den Standardneigungsmesser für relative Werte zurück.
GetDeviceSelector(SensorReadingType)	Ruft die Geräteauswahl ab.

Ereignisse

ReadingChanged

Tritt jedes Mal auf, wenn der Neigungsmesser einen neuen Sensorwert meldet.

Weitere Informationen

• Neigungsmesserbeispiel
• Sensordaten und Anzeigeausrichtung
• Relatives Neigungsmesserbeispiel