Démarrage rapide : configuration de notifications périodiques (HTML)

[ 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 ]

Remarque  Vous n’utilisez pas JavaScript ? Voir Démarrage rapide : configuration de notifications périodiques (XAML).

 

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.

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

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="TileSquare150x150Text04" fallback="TileSquareText04">
      <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);

Récapitulatif et étapes suivantes

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