LightSensor Clase

Definición

Espacio de nombres:

Windows.Devices.Sensors

Representa un sensor de luz ambiental que proporciona la lectura de luz ambiental como un valor LUX.

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

Public NotInheritable Class LightSensor

Herencia

Object Platform::Object IInspectable LightSensor

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

Para obtener una implementación de ejemplo, consulte la muestra de sensor de luz.

Comentarios

En el ejemplo siguiente se muestra cómo una aplicación para UWP compilada con XAML y C# usa el método GetDefault para establecer una conexión a un sensor de luz. Si no se encuentra ningún sensor de luz integrado, el método devolverá un valor NULL.

_sensor = LightSensor.GetDefault();

En el ejemplo siguiente se muestra cómo una aplicación para UWP compilada con XAML registra un controlador de eventos ReadingChanged .

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

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _sensor.ReadingChanged += new TypedEventHandler<LightSensor, LightSensorReadingChangedEventArgs>(ReadingChanged);

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

En el ejemplo siguiente se muestra el controlador de eventos ReadingChanged .

async private void ReadingChanged(object sender, LightSensorReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        LightSensorReading reading = e.Reading;
        ScenarioOutput_LUX.Text = String.Format("{0,5:0.00}", reading.IlluminanceInLux);
    });
}

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
1709	16299	MaxBatchSize
1709	16299	ReportLatency
2004	19041	ReportThreshold

Propiedades

DeviceId	Obtiene el identificador del dispositivo.
MaxBatchSize	Obtiene el número máximo de eventos que el sensor puede procesar por lotes.
MinimumReportInterval	Obtiene el intervalo de informe mínimo admitido por el sensor.
ReportInterval	Obtiene o establece el intervalo de informe actual para el sensor de luz ambiente.
ReportLatency	Obtiene o establece el retraso entre lotes de información del sensor.
ReportThreshold	Obtiene lightSensorDataThreshold para el sensor de luz.

Métodos

FromIdAsync(String)	Obtiene de forma asincrónica el sensor de su identificador.
GetCurrentReading()	Obtiene la lectura actual del sensor de luz ambiental.
GetDefault()	Devuelve el sensor de luz ambiental predeterminado.
GetDeviceSelector()	Obtiene el selector de dispositivos.

Eventos

ReadingChanged

Se produce cada vez que el sensor de luz ambiental notifica una nueva lectura del sensor.

Consulte también

• Muestra de LightSensor
• Ejemplo de sensor de luz (Windows 10)