Comment utiliser la file d’attente de notifications (HTML)

  • Article

[ 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 Comment utiliser la file d’attente de notifications (XAML).

 

Cette rubrique indique comment activer la file d’attente de notifications sur votre vignette, en utilisant notamment des notifications locales dans le cas précis. Elle montre également comment baliser votre notification avant de l’envoyer afin d’éviter tout contenu en double ou obsolète dans la file d’attente. Une fois la file d’attente de notification activée, Windows parcourt jusqu’à cinq notifications.

Pour accéder aux versions C#, C++ ou Visual Basic des exemples JavaScript fournis dans cette rubrique de démarrage rapide, voir Comment utiliser la file d’attente de notifications (C#, C++ ou Visual Basic).

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 vignettes et de badges d’application.

 

Ce que vous devez savoir

Technologies

  • Windows Runtime

Prérequis

Conditions préalables à la compréhension de cette rubrique :

Instructions

Étape 1: Facultatif : Déclarer une variable d’espace de noms

Cette étape permet d’utiliser un nom court à la place du nom complet de l’espace de noms. Elle équivaut à l’instruction « using » dans C# ou « Imports » dans Visual Basic. Elle vous permet de simplifier votre code.

Remarque  Il est supposé que cette variable est déclarée pour le reste du code inclus dans la présente rubrique de démarrage rapide.

 


var notifications = Windows.UI.Notifications;

Étape 2: Définir l’option permettant d’activer le cycle de notification

Ce code active la file d’attente de notification de votre application. Cet appel doit être émis une seule fois pendant que l’application s’exécute, même si cela ne pose aucun problème de le renouveler. Nous vous conseillons de placer cet appel dans le code d’initialisation de votre application. Cela permet de s’assurer que l’appel est émis avant de mettre à jour la vignette localement, de demander un canal de notification Push ou de démarrer les mises à jour périodiques de la vignette.


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

Étape 3: Créer une notification par vignette

Il s’agit de la première étape pour toutes les notifications par vignette. Elle n’est nullement différente des autres situations et est incluse dans un souci d’exhaustivité. Pour plus d’informations, voir Démarrage rapide : Envoi d’une mise à jour de vignette.

Remarque  Quand getTemplateContent est appelée sur un système Windows 8, elle retourne un modèle de version 1. Quand cette méthode est appelée sur un système Windows 8.1, elle retourne un modèle de version 2 ou un modèle de version 3 dans le cas de modèles pour Windows Phone uniquement. Toutefois, si une application spécifie la compatibilité Windows 8 dans son manifeste, cette méthode retourne un modèle de version 1 quelle que soit la version de Windows. Dans cette rubrique, nous allons utiliser un modèle de version 2.

 


var template = notifications.TileTemplateType.tileWide310x150ImageAndText01;                      
var tileXml = notifications.TileUpdateManager.getTemplateContent(template);

// TO DO: Fill in the template with your tile content. Define a tile and add it to tileXML.

var tileNotification = new notifications.TileNotification(tileXml);

Étape 4: Facultatif : attribuer une balise à votre notification

Une balise est une chaîne composée au maximum de 16 caractères alphanumériques, auxquels s’ajoute un caractère Null de fin, qui identifie de manière unique sa notification au sein de votre application.

Lorsque la mise en file d’attente est activée, le cycle maximal de notifications par vignette est de cinq sur la vignette. Par défaut, la stratégie de remplacement des notifications dans la file d’attente est de type premier entré, premier sorti (FIFO). Quand la file d’attente est plein et qu’une nouvelle notification arrive, la notification la plus ancienne est supprimée. Notez que l’ordre d’affichage des notifications ne respecte pas de modèle linéaire strict. Les utilisateurs peuvent voir les notifications dans un ordre différent de celui dans lequel elles sont arrivées.

Pour remplacer le comportement FIFO de la file d’attente, une notification peut recevoir une balise. Si une nouvelle notification arrive avec la même balise qu’une notification existante, la nouvelle notification remplace l’ancienne quelle que soit la place de la plus ancienne notification dans la file d’attente. Si par exemple votre vignette indique des cours de bourse, vous voudrez montrer les informations les plus à jour. L’utilisation de balises pour remplacer les notifications dans la file d’attente est facultative.

Pour plus d’informations sur l’utilisation des balises avec la file d’attente de notifications, voir Utiliser la file d’attente de notifications. L’exemple ci-dessous indique comment définir la balise pour les notifications locales. Pour obtenir des informations sur la définition de balises pour les mises à jour périodiques, voir Tileupdater.startPeriodicUpdateBatch. Pour obtenir des informations sur la définition de balises pour les notifications Push, voir En-têtes des demandes et des réponses du service de notifications Push.

tileNotification.tag = "stockMSFT";

Étape 5: Envoyer la notification à la vignette


notifications.TileUpdateManager.createTileUpdaterForApplication().update(tileNotification);

Rubriques associées

Démarrage rapide : envoi d’une mise à jour de vignette

Exemple de vignettes et de badges d’application

Tailles des images de vignette et de toast

Vue d’ensemble des vignettes et des notifications par vignette

Recommandations et liste de vérification sur les vignettes