Usar o sensor de luz
Saiba como usar o sensor de luz ambiente para detectar mudanças na iluminação.
APIs importantes
Pré-requisitos
Você deve estar familiarizado com XAML (Extensible Application Markup Language), Microsoft Visual C# e eventos.
O dispositivo ou emulador que você está usando deve dar suporte a um sensor de luz ambiente.
Crie um aplicativo de sensor de luz simples
Um sensor de luz ambiente é um dos vários tipos de sensores ambientais que permitem que os aplicativos respondam a mudanças no ambiente do usuário.
Observação
Para uma implementação mais completa, consulte o exemplo de sensor de luz.
Instruções
Crie um novo projeto, escolhendo um Aplicativo em Branco (Universal do Windows) nos modelos de projeto do Visual C# .
Abra o arquivo BlankPage.xaml.cs do seu projeto e substitua o código existente pelo seguinte.
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Windows.UI.Core; // Required to access the core dispatcher object
using Windows.Devices.Sensors; // Required to access the sensor platform and the ALS
// The Blank Page item template is documented at https://go.microsoft.com/fwlink/p/?linkid=234238
namespace App1
{
/// <summary>
/// An empty page that can be used on its own or navigated to within a Frame.
/// </summary>
public sealed partial class BlankPage : Page
{
private LightSensor _lightsensor; // Our app' s lightsensor object
// This event handler writes the current light-sensor reading to
// the textbox named "txtLUX" on the app' s main page.
private void ReadingChanged(object sender, LightSensorReadingChangedEventArgs e)
{
Dispatcher.RunAsync(CoreDispatcherPriority.Normal, (s, a) =>
{
LightSensorReading reading = (a.Context as LightSensorReadingChangedEventArgs).Reading;
txtLuxValue.Text = String.Format("{0,5:0.00}", reading.IlluminanceInLux);
});
}
public BlankPage()
{
InitializeComponent();
_lightsensor = LightSensor.GetDefault(); // Get the default light sensor object
// Assign an event handler for the ALS reading-changed event
if (_lightsensor != null)
{
// Establish the report interval for all scenarios
uint minReportInterval = _lightsensor.MinimumReportInterval;
uint reportInterval = minReportInterval > 16 ? minReportInterval : 16;
_lightsensor.ReportInterval = reportInterval;
// Establish the even thandler
_lightsensor.ReadingChanged += new TypedEventHandler<LightSensor, LightSensorReadingChangedEventArgs>(ReadingChanged);
}
}
}
}
Você precisará renomear o namespace no snippet anterior com o nome que você deu ao seu projeto. Por exemplo, se você criou um projeto chamado LightingCS, substitua namespace App1 por namespace LightingCS.
- Abra o arquivo MainPage.xaml e substitua o conteúdo original pelo XML a seguir.
<Page
x:Class="App1.BlankPage"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:App1"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d">
<Grid x:Name="LayoutRoot" Background="Black">
<TextBlock HorizontalAlignment="Left" Height="44" Margin="52,38,0,0" TextWrapping="Wrap" Text="LUX Reading" VerticalAlignment="Top" Width="150"/>
<TextBlock x:Name="txtLuxValue" HorizontalAlignment="Left" Height="44" Margin="224,38,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="217"/>
</Grid>
</Page>
Você precisará substituir a primeira parte do nome da classe no snippet anterior pelo namespace do seu aplicativo. Por exemplo, se você criou um projeto chamado LightingCS, substitua x:Class="App1.MainPage" por x:Class="LightingCS.MainPage". Você também deve substituir xmlns:local="using:App1" por xmlns:local="using:LightingCS".
- Pressione F5 ou selecione Depurar>Iniciar Depuração para compilar, implantar e executar o aplicativo.
Depois que o aplicativo estiver em execução, você poderá alterar os valores do sensor de luz alterando a luz disponível para o sensor ou usando as ferramentas do emulador.
- Pare o aplicativo retornando ao Visual Studio e pressionando Shift+F5 ou selecione Depurar>Parar Depuração para interromper o aplicativo.
Explicação
O exemplo anterior demonstra o pouco código que você precisará escrever para integrar a entrada do sensor de luz em seu aplicativo.
O aplicativo estabelece uma conexão com o sensor padrão no método BlankPage .
_lightsensor = LightSensor.GetDefault(); // Get the default light sensor object
O aplicativo estabelece o intervalo de relatório dentro do método BlankPage . Esse código recupera o intervalo mínimo com suporte do dispositivo e o compara a um intervalo solicitado de 16 milissegundos (que se aproxima de uma taxa de atualização de 60 Hz). Se o intervalo mínimo com suporte for maior que o intervalo solicitado, o código definirá o valor como o mínimo. Caso contrário, ele define o valor para o intervalo solicitado.
uint minReportInterval = _lightsensor.MinimumReportInterval;
uint reportInterval = minReportInterval > 16 ? minReportInterval : 16;
_lightsensor.ReportInterval = reportInterval;
Os novos dados do sensor de luz são capturados no método ReadingChanged . Cada vez que o driver do sensor recebe novos dados do sensor, ele passa o valor para seu aplicativo usando esse manipulador de eventos. O aplicativo registra esse manipulador de eventos na linha a seguir.
_lightsensor.ReadingChanged += new TypedEventHandler<LightSensor,
LightSensorReadingChangedEventArgs>(ReadingChanged);
Esses novos valores são gravados em um TextBlock encontrado no XAML do projeto.
<TextBlock HorizontalAlignment="Left" Height="44" Margin="52,38,0,0" TextWrapping="Wrap" Text="LUX Reading" VerticalAlignment="Top" Width="150"/>
<TextBlock x:Name="txtLuxValue" HorizontalAlignment="Left" Height="44" Margin="224,38,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="217"/>