Windows Dev Center

LightSensor.GetCurrentReading | getCurrentReading Method

Ruft die aktuellen Werte des Umgebungslichtmessers ab.

Syntax


var lightSensorReading = lightSensor.getCurrentReading();

Parameter

Methode besitzt keine Parameter.

Rückgabewert

Typ: LightSensorReading

Der aktuelle Messwert des Umgebungslichtsensors.

Hinweise

Eine Anwendung kann diese Methode verwenden, um den Sensor für den aktuellen Wert als Alternative zur Registrierung eines ReadingChanged-Ereignishandlers abzurufen. Dies wäre die bevorzugte Alternative für eine Anwendung, dessen Benutzeroberfläche zu bestimmten Frameraten aktualisiert wird. Die Anwendung muss ein gewünschtes ReportInterval einrichten, ganz gleich, ob einmal oder mehrmals abgerufen wird. Dies informiert den Sensortreiber darüber, dass Ressourcen zugeordnet werden sollten, um nachfolgende Abrufanforderungen zu erfüllen

Vor der Verwendung des Rückgabewerts dieser Methode muss die Anwendung zunächst prüfen, ob der Wert nicht NULL ist. (Wenn der Wert NULL ist und Sie versuchen, ihn abzurufen, wird eine Ausnahme generiert.)

Das folgende Beispiel zeigt, wie eine mit XAML und C# erstellte Windows Store-App die aktuelle Messung für den standardmäßigen Lichtsensor abruft.


private void DisplayCurrentReading(object sender, object args)
{
    LightSensorReading reading = _sensor.GetCurrentReading();
    if (reading != null)
    {
        ScenarioOutput_LUX.Text = String.Format("{0,5:0.00}", reading.IlluminanceInLux);
    }
}


Das folgende Beispiel zeigt, wie eine mit JavaScript erstellte Windows Store-App für Windows die aktuelle Messung für den standardmäßigen Lichtsensor abruft.


function getCurrentReading() {
    var reading = lightSensor.getCurrentReading();
    if (reading) {
        document.getElementById("readingOutputIlluminance").innerHTML = reading.illuminanceInLux.toFixed(2);
    }
}


Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Keine unterstützt

Namespace

Windows.Devices.Sensors
Windows::Devices::Sensors [C++]

Metadaten

Windows.winmd

Siehe auch

LightSensor

 

 

Anzeigen:
© 2015 Microsoft