Démarrage rapide : configuration de notifications périodiques (applications du Windows Store en JavaScript et HTML)

Cette rubrique vous montre comment lancer une interrogation périodique d’une URL pour obtenir le contenu mis à jour de la vignette de votre application.

Pour accéder aux versions C#, C++ ou Visual Basic des exemples JavaScript fournis dans cette rubrique de démarrage rapide, voir Configuration de notifications périodiques (C#, C++ ou Visual Basic).

Nous recommandons que toutes les notifications interrogées utilisent l’en-tête de réponse HTTP X-WNS-Expires dans le cadre de la définition d’un délai d’expiration explicite. Pour plus d’informations sur la définition de l’en-tête X-WNS-Expires, voir TileUpdater.StartPeriodicUpdate ou TileUpdater.StartPeriodicUpdateBatch.

Remarque  Dans cette rubrique de démarrage rapide, vous allez manipuler le contenu de la notification directement via le modèle DOM (Document Object Model) XML. Une approche facultative est disponible via la bibliothèque NotificationsExtensions, présentant le contenu XML sous forme de propriétés d’objet, y compris IntelliSense. Pour plus d’informations, voir Démarrage rapide : utilisation de la bibliothèque NotificationsExtensions dans votre code. Pour accéder au code de cette rubrique de démarrage rapide exprimé à l’aide de NotificationsExtensions, voir l’exemple de notifications Push et périodiques.

Prérequis

  • Bonnes connaissances des termes et des concepts de vignette et de notification. Pour plus d’informations, voir Vignettes, badges et notifications.
  • Compréhension des concepts de notification (interrogation) périodique. Pour plus d’informations, voir Vue d’ensemble des notifications périodiques.
  • Aptitude à créer une application élémentaire Windows Store en JavaScript à l’aide des API Windows Runtime.
  • Service Web qui héberge le contenu de la notification par vignette.

Instructions

1. Créer ou identifier un service Web pour héberger le contenu XML de la vignette

À intervalles spécifiés, Windows interroge le service Web spécifié afin d’obtenir le contenu mis à jour de la vignette pour votre application. Le service Web doit prendre en charge le protocole HTTP. À des fins de test du code XML, vous pouvez également configurer un service Web, tel que les services Internet (IIS) de Microsoft, sur votre ordinateur local.

2. Placer le fichier XML du contenu de votre vignette à un emplacement Web accessible

Votre service Web va héberger le contenu XML de la vignette. Pour commencer, hébergez le contenu XML de la vignette indiqué ici sur votre site Web. Enregistrez ce contenu dans un fichier nommé Tile.xml et placez le fichier sur le serveur à un emplacement Web accessible (par exemple, http://www.fabrikam.com/tile.xml). Le contenu du document XML doit utiliser un codage UTF-8 et se conformer au schéma de vignette. Vous devez mettre à jour ce contenu XML au moins aussi souvent que l’intervalle de récurrence d’interrogation spécifié.



<tile>
  <visual version="2">
    <binding template="TileWide310x150Text03" fallback="TileWideText03">
      <text id="1">Hello world!</text>
    </binding>  
  </visual>
</tile>

3. Commencer les mises à jour périodiques (URL unique)

Cet exemple montre comment démarrer l’interrogation d’une URL unique pour fournir à la vignette du nouveau contenu une fois par heure. Ce code utilise une variable précédemment définie appelée polledUrl, laquelle correspond à une chaîne spécifiant l’URL à interroger.



var notifications = Windows.UI.Notifications;
var recurrence = notifications.PeriodicUpdateRecurrence.hour;
var url = new Windows.Foundation.Uri(polledUrl);

notifications.TileUpdateManager.createTileUpdaterForApplication().startPeriodicUpdate(url, recurrence);

4. Commencer les mises à jour périodiques (URL multiples)

Windows peut interroger jusqu’à cinq URL différentes afin de fournir du contenu défilant au sein de la file d’attente de notifications de la vignette.

Cet exemple montre comment interroger plusieurs URL sur du nouveau contenu une fois par heure. Si ce n’est déjà fait, commencez par activer la file d’attente de notifications. Notez que enableNotificationQueue ne doit être appelé qu’une seule fois après installation de l’application ou création d’une vignette secondaire par l’utilisateur. Le code fourni en exemple inclut une variable précédemment définie appelée urisToPoll, laquelle correspond à un ensemble d’objets Windows.Foundation.Uri.

Remarque  Les mises à jour de vignette périodiques prennent en charge la balise de notification par vignette utilisée au sein de la logique de remplacement de la file d’attente de notifications. Votre service peut définir la balise sur chaque notification en fournissant l’en-tête de réponse HTTP X-WNS-Tag. Pour plus d’informations sur l’utilisation des balises et de la file d’attente de notifications, voir Comment utiliser la file d’attente de notifications avec des notifications locales. Pour plus d’informations sur l’utilisation de l’en-tête de réponse HTTP X-WNS-Tag avec les notifications périodiques, voir TileUpdater.startPeriodicUpdateBatch.



var notifications = Windows.UI.Notifications;                        
var recurrence = notifications.PeriodicUpdateRecurrence.hour;

notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

notifications.TileUpdateManager.createTileUpdaterForApplication().startPeriodicUpdateBatch(urisToPoll, recurrence);

Cette rubrique de démarrage rapide vous a guidé pas à pas dans la configuration d’une notification par vignette périodique.La même technique peut être utilisée sur les badges.

Rubriques associées

Exemple de notifications Push et périodiques
Recommandations pour les notifications périodiques
Comment utiliser la file d’attente de notifications avec des notifications locales

 

 

Afficher:
© 2014 Microsoft. Tous droits réservés.