OrientationSensor.GetDefault Methode

Definition

Überlädt

GetDefault()

Gibt den Standardausrichtungssensor für absolute Messwerte zurück.

GetDefault(SensorReadingType)

Gibt den Standardausrichtungssensor unter Berücksichtigung der Genauigkeitseinstellungen zurück.

GetDefault(SensorReadingType, SensorOptimizationGoal)

Gibt den Standardausrichtungssensor unter Berücksichtigung der Leistungs- und Genauigkeitseinstellungen zurück.

GetDefault()

public:
 static OrientationSensor ^ GetDefault();
 static OrientationSensor GetDefault();
/// [Windows.Foundation.Metadata.Overload("GetDefault")]
 static OrientationSensor GetDefault();
public static OrientationSensor GetDefault();
[Windows.Foundation.Metadata.Overload("GetDefault")]
public static OrientationSensor GetDefault();
function getDefault()
Public Shared Function GetDefault () As OrientationSensor

Gibt zurück

Der Standardausrichtungssensor oder NULL , wenn keine Orientierungssensoren gefunden werden.

Attribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine mit XAML und C# erstellte UWP-App diese Methode verwendet hat, um eine Verbindung mit dem Ausrichtungssensor herzustellen.

_sensor = OrientationSensor.GetDefault();

Hinweise

Diese Methode gibt das gleiche Ergebnis wie GetDefault(SensorReadingType.Absolute) zurück.

Diese Methode gibt nur Werte für Hardware zurück, die vom Hersteller in den Computer integriert wurde. (Die Orientierungssensor-Messwerte werden von mehreren Sensoren abgeleitet.) Ein NULL-Wert wird zurückgegeben, wenn der angegebene Sensor im System nicht verfügbar ist.

Wenn sich ein System im verbundenen Standbymodus befindet, wird ein Aufruf der GetDefault-Methode sofort mit null zurückgegeben.

Weitere Informationen

Gilt für:

GetDefault(SensorReadingType)

Gibt den Standardausrichtungssensor unter Berücksichtigung der Genauigkeitseinstellungen zurück.

public:
 static OrientationSensor ^ GetDefault(SensorReadingType sensorReadingtype);
/// [Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingType")]
 static OrientationSensor GetDefault(SensorReadingType const& sensorReadingtype);
[Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingType")]
public static OrientationSensor GetDefault(SensorReadingType sensorReadingtype);
function getDefault(sensorReadingtype)
Public Shared Function GetDefault (sensorReadingtype As SensorReadingType) As OrientationSensor

Parameter

sensorReadingtype
SensorReadingType

Der Typ des abzurufenden Sensors. Ein absoluter SensorReadingType gibt einen OrientationSensor mit einem Beschleunigungsmesser, einem Gyromoter und einem Magnetometer zurück, um die Ausrichtung in Bezug auf magnetischen Norden zu bestimmen. Ein relativer SensorReadingType gibt einen OrientationSensor zurück, der nur einen Beschleunigungsmesser und ein Gyrometer (kein Magnetometer) verwendet und relativ zu dem Ort misst, an dem der Sensor zuerst instanziiert wurde."

Gibt zurück

Der Standardausrichtungssensor oder NULL , wenn keine Orientierungssensoren gefunden werden.

Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Hinweise

Diese Methode gibt nur Werte für Hardware zurück, die vom Hersteller in den Computer integriert wurde. (Die Orientierungssensor-Messwerte werden von mehreren Sensoren abgeleitet.) Ein NULL-Wert wird zurückgegeben, wenn der angegebene Sensor im System nicht verfügbar ist.

Wenn sich ein System im verbundenen Standbymodus befindet, wird ein Aufruf der GetDefault-Methode sofort mit null zurückgegeben.

Weitere Informationen

Gilt für:

GetDefault(SensorReadingType, SensorOptimizationGoal)

Gibt den Standardausrichtungssensor unter Berücksichtigung der Leistungs- und Genauigkeitseinstellungen zurück.

public:
 static OrientationSensor ^ GetDefault(SensorReadingType sensorReadingType, SensorOptimizationGoal optimizationGoal);
/// [Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingTypeAndSensorOptimizationGoal")]
 static OrientationSensor GetDefault(SensorReadingType const& sensorReadingType, SensorOptimizationGoal const& optimizationGoal);
[Windows.Foundation.Metadata.Overload("GetDefaultWithSensorReadingTypeAndSensorOptimizationGoal")]
public static OrientationSensor GetDefault(SensorReadingType sensorReadingType, SensorOptimizationGoal optimizationGoal);
function getDefault(sensorReadingType, optimizationGoal)
Public Shared Function GetDefault (sensorReadingType As SensorReadingType, optimizationGoal As SensorOptimizationGoal) As OrientationSensor

Parameter

sensorReadingType
SensorReadingType

Der Typ des abzurufenden Sensors. Ein absoluter SensorReadingType gibt einen OrientationSensor mit einem Beschleunigungsmesser, einem Gyromoter und einem Magnetometer zurück, um die Ausrichtung in Bezug auf magnetischen Norden zu bestimmen. Ein relativer SensorReadingType gibt einen OrientationSensor zurück, der nur einen Beschleunigungsmesser und ein Gyrometer (kein Magnetometer) verwendet und relativ zu dem Ort misst, an dem der Sensor zuerst instanziiert wurde.

optimizationGoal
SensorOptimizationGoal

Gibt die Optimierungseinstellungen für den Sensor an. Dieses Feld wird nur verwendet, wenn ein Absolute SensorReadingType angegeben ist. Ein OptimizationGoal of Precision gibt einen OrientationSensor mit einem Beschleunigungsmesser, einem Gyrometer und einem Magnetometer zurück, um die Ausrichtung in Bezug auf den magnetischen Norden zu bestimmen. Dies hat das Potenzial, durch den Einsatz eines Gyrometers viel Kraft zu nutzen. Im Gegensatz dazu gibt die Angabe einer OptimierungGoal von PowerEfficiency einen OrientationSensor zurück, der nur einen Beschleunigungsmesser und ein Magnetometer (kein Gyrometer) verwendet, um Strom zu sparen, was eine gewisse Genauigkeit kostet (die Messwerte sind in den meisten Fällen immer noch relativ genau).

Gibt zurück

Der Standardausrichtungssensor oder NULL , wenn keine Orientierungssensoren gefunden werden.

Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Hinweise

Diese Methode gibt nur Werte für Hardware zurück, die vom Hersteller in den Computer integriert wurde. (Die Orientierungssensor-Messwerte werden von mehreren Sensoren abgeleitet.) Ein NULL-Wert wird zurückgegeben, wenn der angegebene Sensor im System nicht verfügbar ist.

Wenn sich ein System im verbundenen Standbymodus befindet, wird ein Aufruf der GetDefault-Methode sofort mit null zurückgegeben.

Der parameter optimizationGoal ist von der verfügbaren Hardware abhängig. Es wird versucht, den besten verfügbaren Sensor basierend auf Ihrer angegebenen Präferenz für die Optimierung auszuwählen. Es wirkt sich nur aus, wenn sensorReadingTypeabsoluter Wert ist.

Weitere Informationen

Gilt für: