Utilisation de la file d’attente de notifications (applications Windows Runtime)

Applies to Windows and Windows Phone

L’utilisation de la file d’attente de notifications permet à une vignette d’afficher successivement jusqu’à cinq notifications. Par défaut, une vignette de l’écran d’accueil affiche le contenu d’une seule notification jusqu’à ce qu’une nouvelle notification remplace la notification actuelle. Lorsque la mise en file d’attente des notifications est activée, la file d’attente peut comporter jusqu’à cinq notifications que la vignette affiche à tour de rôle. La file d’attente de notifications fonctionne avec tous les types de remise de notification : locale, planifiée, périodique ou Push.

Remarque  La durée et l’ordre d’affichage de chaque notification figurant dans la file d’attente sont déterminés par plusieurs facteurs internes qui ne peuvent pas être contrôlés par les applications.

Remplacement des notifications mises en file d’attente

Par défaut, quand la file d’attente atteint le nombre maximal de cinq notifications, la nouvelle notification suivante remplace la notification la plus ancienne dans la file d’attente. Toutefois, vous pouvez changer cette stratégie de remplacement en définissant des balises sur vos notifications.

Les balises sont des chaînes spécifiques aux applications. Windows analyse la balise d’une notification entrante, vérifie si la file d’attente contient une notification dotée de la même balise et, le cas échéant, remplace la notification existante par la nouvelle. S’il ne trouve pas de notification avec la même balise, il applique la règle FIFO par défaut.

La mise en file d’attente et le marquage des notifications permettent de mettre en œuvre de nombreux scénarios de notification. Par exemple, une application de cotations boursières peut envoyer cinq notifications, chacune d’elles s’appliquant à une action spécifique et portant une balise du nom de l’action en question. De cette manière, la file d’attente ne peut pas comporter deux notifications pour la même action, avec la plus ancienne des deux qui serait obsolète.

Activation de la file d’attente de notifications

Activer la file d’attente de notifications en appelant EnableNotificationQueue. Vous devez effectuer cet appel avant d’envoyer des notifications à votre vignette, en d’autres termes, avant de demander votre premier canal de notification Push, de démarrer des mises à jour périodiques ou d’envoyer des notifications locales à cette vignette. Ne passez pas d’une file d’attente de notifications activée à une file désactivée ; vous devez déterminer si vous prenez en charge la file d’attente dans la conception de votre application pour éviter des comportements de vignette prêtant éventuellement à confusion.

Utilisation de la file d’attente de notification avec des notifications locales et planifiées

La procédure d’envoi de notifications localement à votre vignette (y compris les notifications planifiées) ne change pas lorsque vous utilisez la file d’attente de notifications. Par défaut, les notifications que vous mettez à jour via les API de notification locale sont placées dans la file d’attente selon l’ordre FIFO si la file d’attente est activée. Pour utiliser des balises avec votre notification de vignette locale ou planifiée, indiquez la propriété de balise facultative sur l’objet de notification avant de l’envoyer à la vignette ou de l’ajouter à la planification. Pour plus d’informations, voir TileNotification ou ScheduledTileNotification.

Vous trouverez un exemple de l’utilisation des notifications locales avec la file d’attente de notifications dans la section Comment utiliser la file d’attente de notifications.

Utilisation de la file d’attente de notification avec des notifications Push

La procédure d’envoi des notifications Push à votre vignette ne change pas non plus lorsque la file d’attente de notifications est activée. Par défaut, les notifications que vous mettez à jour via les API de notification Push sont placées dans la file d’attente selon l’ordre FIFO si la file d’attente est activée.

Pour définir des balises sur des notifications Push, votre service cloud doit utiliser l’en-tête HTTP X-WNS-Tag lors de l’envoi de la notification. Pour plus d’informations, voir En-têtes des demandes et des réponses des services de notifications Push.

Si vous avez activé la file d’attente de notifications alors que l’utilisateur est hors connexion, les services de notifications Push Windows (WNS) enregistrent jusqu’à cinq notifications, puis les envoient à l’utilisateur dès que ce dernier est de nouveau en ligne. Ces notifications non remises sont gérées conformément à la règle FIFO standard de mise en file d’attente et à la stratégie de remplacement basée sur les balises.

Utilisation de la file d’attente de notifications avec des mises à jour périodiques

En cas de notifications périodiques, un URI (Uniform Resource Identifier) unique est fourni pour chaque notification. Windows demande périodiquement à l’URI du contenu de notification mis à jour. Vous pouvez fournir un tableau contenant jusqu’à cinq URI, un pour chaque notification, via la méthode StartPeriodicUpdateBatch. Chaque URI interrogé peut éventuellement retourner son propre délai d’expiration et sa propre valeur de balise uniques.

Marquage de notifications pour des mises à jour périodiques

Avec les notifications périodiques, les balises sont fournies dans l’en-tête X-WNS-Tag du message de réponse HTTP de la notification, lequel inclut également le contenu de la notification. Ce message est envoyé en réponse à l’appel périodique du système à l’URI de la notification. Le nom de l’en-tête et la valeur de balise ne respectent pas la casse.

Pour obtenir un exemple d’implémentation complète de notifications périodiques utilisées en association avec la file d’attente de notifications, consultez l’exemple de notifications Push et périodiques.

Rubriques associées

Comment utiliser la file d’attente de notifications avec des notifications locales
Windows.UI.Notifications.TileUpdater.EnableNotificationQueue
Windows.UI.Notifications.TileUpdater.StartPeriodicUpdateBatch

 

 

Afficher:
© 2014 Microsoft