Manipular notificações de cerca geográfica de uma tarefa em segundo plano (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]

Este tópico guia você pelas etapas de manipulação de notificações de Geofence de uma tarefa em segundo plano em seu aplicativo.

Mapa: como este tópico está relacionado aos outros? Veja:

Mapa de aplicativos que usam JavaScript

Introdução

Após a criação das cercas geográficas, você tem que adicionar a lógica para agir quando ocorrer um evento de cerca geográfica. Dependendo dos MonitoredStates configurados, você pode receber um evento quando:

O usuário entrar em uma região de interesse.
O usuário sair de uma região de interesse.
A cerca geográfica expirar ou for removida. Observe que um aplicativo em segundo plano não é ativado para um evento de remoção.

Este tópico descreve como manipular uma notificação de cerca geográfica quando uma tarefa em segundo plano for disparada. Ele presume que você tenha configurado um ouvinte de eventos em segundo plano conforme descrito em Escutar eventos de cerca geográfica em segundo plano. Você também pode manipular eventos diretamente de seu aplicativo quando ele está em execução. Para saber mais, veja Manipular notificações de cerca geográfica em primeiro plano e Diretrizes para cerca geográfica.

Manipulando a notificação em segundo plano

As ações executadas para notificar o usuário depende do que seu aplicativo faz, mas você talvez possa exibir uma notificação do sistema, reproduzir um som de áudio ou atualizar um bloco dinâmico. O código a seguir manipula a notificação:


function onCompleted() {
    try {
        // Update the UI with the completion status of the background task
        // The Run method of the background task sets the LocalSettings. 
        var settings = Windows.Storage.ApplicationData.current.localSettings;

        // get status
        if (settings.values.hasKey("Status")) {
            WinJS.log && WinJS.log(settings.values["Status"].toString(), "sample", "status");
        }

        // do your apps work here

    } catch (ex) {
        // The background task had an error
        WinJS.log && WinJS.log(ex.toString(), "sample", "error");
    }
}