Guia de início rápido: reagindo a mudanças na iluminação (HTML)

Artigo
12/12/2015

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Você pode usar o sensor de luz ambiente para detectar mudanças na iluminação com um aplicativo escrito em JavaScript.

O namespace Windows.Devices.Sensors inclui suporte para um objeto LightSensor que os aplicativos podem usar para recuperar a iluminação atual como um valor LUX. Para saber mais sobre valores LUX, consulte a documentação da API do Sensor no MSDN.

Objetivo: Depois de concluir esse guia de início rápido, você compreenderá como usar um sensor de luz para recuperar a iluminação atual como um valor LUX.

Pré-requisitos

Você deve estar familiarizado com HTML, JavaScript e eventos.

O dispositivo ou emulador que você está usando deve ter suporte para um sensor de luz.

Tempo para conclusão: 15 minutos.

Instruções

1. Abrir o Microsoft Visual Studio

Abra uma instância do Visual Studio.

2. Criar um novo projeto

Crie um novo projeto, escolhendo um Aplicativo em Branco nos tipos de projetos de Aplicativos JavaScript/Store.

3. Substituir o código JavaScript

Abra o arquivo default.js do projeto e substitua o código existente pelo seguinte.


// For an introduction to the Blank template, see the following documentation:
// https://go.microsoft.com/fwlink/p/?linkid=232509
(function () {
    "use strict";
    var lightSensor;

    // This function is invoked within onDataChanged to
    // retrieve the given identifier from the HTML document.
    function id(elementId) {
        return document.getElementById(elementId);
    }

    // This function is called each time an accelerometer event
    // is fired by the driver.
    function onDataChanged(e) {
        id('eventOutputIlluminance').innerHTML = e.reading.illuminanceInLux.toFixed(2);
    }

    var app = WinJS.Application;

    // This function responds to all app activations.
    app.onactivated = function (eventObject) {
        if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.launch) {
            if (lightSensor == null) {
                lightSensor = Windows.Devices.Sensors.LightSensor.getDefault();

                // Set the report interval
                var minimumReportInterval = lightSensor.minimumReportInterval;
                var reportInterval = minimumReportInterval > 16 ? minimumReportInterval : 16;
                lightSensor.reportInterval = reportInterval;

                // Establish the event handler
                lightSensor.addEventListener("readingchanged", onDataChanged);

            WinJS.UI.processAll();
        }
    };

    app.start();
})();

4. Adicionar o HTML para os aplicativos

Abra o arquivo default.html dos projetos do Windows e do Windows Phone e copie o seguinte HTML para dentro das marcas BODY do arquivo.


<div class="item" id="scenario1Output">
    Illuminance: <a id="eventOutputIlluminance">no data</a>
</div>

5. Criar, implantar e executar o aplicativo

Pressione F5 ou selecione Depurar > Iniciar Depuração) para criar, implantar e executar o aplicativo.

Quando o arquivo está executando, você pode alterar os valores do acelerômetro movendo o dispositivo ou usando as ferramentas do emulador.

6. Parar o aplicativo

Pressione Alt+Tab para retornar ao Visual Studio.
Pressione Shift-F5 ou selecione Depurar > Parar Depuração) para parar o aplicativo.

Resumo e próximas etapas

O exemplo anterior demonstra a codificação mínima que será necessária gravar para integrar a entrada do sensor de luz no aplicativo.

Neste exemplo, os novos dados do sensor são capturados na função onDataChanged. Toda vez que o driver do sensor detecta uma alteração nas leituras do sensor de luz, ele transmite os novos valores para seu aplicativo usando esta função (ou o manipulador de eventos).

    function onDataChanged(e) {
        id('eventOutputIlluminance').innerHTML = e.reading.illuminanceInLux.toFixed(2);
    }

Esses novos valores são gravados na tela por meio de atualizações nos elementos DOM mostrados a seguir:

<div class="item" id="scenario1Output">
    Illuminance: <a id="eventOutputIlluminance">no data</a>
</div>

O aplicativo estabelece o intervalo de relatório dentro da função onactivated. Este código recupera o intervalo mínimo suportado pelo dispositivo e o compara com um intervalo solicitado de 16 milissegundos (aproximadamente a uma taxa de atualização de 60-Hz). Se o intervalo mínimo suportado for maior que o intervalo solicitado, o código definirá valor mínimo. Caso contrário, ele define o valor como o intervalo solicitado.

var minimumReportInterval = accelerometer.minimumReportInterval;
var reportInterval = minimumReportInterval > 16 ? minimumReportInterval : 16;
accelerometer.reportInterval = reportInterval;

Se você está gravando um aplicativo simples, as próximas etapas geralmente envolvem a integração da entrada do sensor com a saída do gráfico.

Por exemplo, você poderá criar um aplicativo simples de leitor de texto que reaja a mudanças na iluminação aumentando ou diminuindo o contraste entre as cores de primeiro e tela de fundos.

Tópicos relacionados

LightSensor class

Exemplo de LightSensor

Partilhar via