Gérer des notifications de clôture virtuelle à partir d’une tâche en arrière-plan (HTML)

Article
12/11/2015

[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Cette rubrique vous guide tout au long des étapes nécessaires pour gérer des notifications Geofence à partir d’une tâche en arrière-plan, dans votre application.

Feuille de route : comment cette rubrique s’articule-t-elle par rapport aux autres ? Voir :

Feuille de route pour les applications en JavaScript

Introduction

Une fois vos clôtures virtuelles (parfois appelées « géorepères ») créées, vous devrez ajouter la logique afin de gérer ce qui se passe quand un événement de géorepérage survient. En fonction de la propriété MonitoredStates que vous avez configurée, il est possible que vous receviez un événement quand :

l’utilisateur a entré une région d’intérêt ;
l’utilisateur a quitté une région d’intérêt ;
la clôture virtuelle a expiré ou a été supprimée. Notez qu’aucune application en arrière-plan n’est activée pour un événement de suppression.

Cette rubrique décrit la manière de gérer une notification de clôture virtuelle lorsqu’une tâche en arrière-plan est déclenchée. Elle part du principe que vous avez configuré un détecteur d’événements en arrière-plan comme le décrit la rubrique Détecter des événements de clôture virtuelle en arrière-plan. Vous pouvez également gérer des événements directement depuis votre application lorsqu’elle est en cours d’exécution. Pour en savoir plus, voir Gérer des notifications de clôture virtuelle au premier plan et Recommandations en matière de géorepérage.

Gestion de la notification en arrière-plan

Les actions que vous entreprenez pour notifier l’utilisateur dépendent de ce qu’accomplit votre application mais vous pouvez sans doute afficher une notification toast, diffuser un son ou mettre à jour une vignette dynamique. Le code ci-dessous gère la notification :


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");
    }
}