LightSensor Classe

Definição

Namespace:

Windows.Devices.Sensors

Representa um sensor de luz ambiente que fornece a leitura de luz ambiente como um 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

Herança

Object Platform::Object IInspectable LightSensor

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Para obter um exemplo de implementação, consulte o exemplo de sensor de luz.

Comentários

O exemplo a seguir demonstra como um aplicativo UWP criado com XAML e C# usa o método GetDefault para estabelecer uma conexão com um sensor de luz. Se nenhum sensor de luz integrado for encontrado, o método retornará um valor nulo.

_sensor = LightSensor.GetDefault();

O exemplo a seguir demonstra como um aplicativo UWP criado com XAML registra um manipulador 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);
    }
}

O exemplo a seguir mostra o manipulador 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);
    });
}

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1.709	16299	FromIdAsync
1.709	16299	GetDeviceSelector
1.709	16299	MaxBatchSize
1.709	16299	ReportLatency
2004	19041	ReportThreshold

Propriedades

DeviceId	Obtém o identificador do dispositivo.
MaxBatchSize	Obtém o número máximo de eventos que podem ser agrupados em lote pelo sensor.
MinimumReportInterval	Obtém o intervalo mínimo de relatório com suporte pelo sensor.
ReportInterval	Obtém ou define o intervalo de relatório atual para o sensor de luz ambiente.
ReportLatency	Obtém ou define o atraso entre lotes de informações do sensor.
ReportThreshold	Obtém o LightSensorDataThreshold para o sensor de luz.

Métodos

FromIdAsync(String)	Obtém de forma assíncrona o sensor de seu identificador.
GetCurrentReading()	Obtém a leitura atual do sensor de luz ambiente.
GetDefault()	Retorna o sensor de luz ambiente padrão.
GetDeviceSelector()	Obtém o seletor de dispositivo.

Eventos

ReadingChanged

Ocorre sempre que o sensor de luz ambiente relata uma nova leitura do sensor.

Confira também

• Exemplo de LightSensor
• Amostra de sensor claro (Windows 10)