OrientationSensor.GetDefault Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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 OrientationSensorGibt 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 OrientationSensorParameter
- 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 OrientationSensorParameter
- 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.