LightSensor Classe

  • Referência

Definição

Namespace:
Windows.Devices.Sensors
Editar

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.

Aplica-se a

Confira também