Partager via

Horodatages personnalisés sur les notifications d’application

Par défaut, l’horodatage sur les notifications d’application, visible dans le Centre de notification, est défini sur l’heure à laquelle la notification a été envoyée. Vous pouvez éventuellement remplacer l’horodatage par votre propre date et heure personnalisées afin que l’horodatage représente l’heure de création du message/information/contenu, plutôt que de l’heure à laquelle la notification a été envoyée. Cela garantit également que vos notifications apparaissent dans l’ordre correct dans le Centre de notifications, qui est trié par heure. Nous vous recommandons que la plupart des applications spécifient un horodatage personnalisé.

Cette fonctionnalité est disponible dans Windows Build 15063 et versions ultérieures.

Notification d’application avec horodatage personnalisé

Note

Le terme « notification toast » est remplacé par « notification d'appli ». Ces termes font tous deux référence à la même fonctionnalité de Windows, mais au fil du temps, nous cesserons progressivement d'utiliser le terme « toast notification » dans la documentation.

Pour utiliser un horodatage personnalisé, affectez simplement la propriété displayTimestamp sur l’élément toast de la charge utile XML de notification de votre application. À compter du Kit de développement logiciel (SDK) d’application Windows 1.2, vous pouvez ajouter un horodatage personnalisé à une notification d’application avec Microsoft.Windows.AppNotifications.Builder. Pour les applications UWP, vous pouvez utiliser la version 1.4.0 ou une version ultérieure de la bibliothèque NuGet pour les notifications du UWP Community Toolkit . YOu spécifie également l’horodatage à l’aide de xml brut.

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));

Si vous utilisez du code XML, la date doit être mise en forme dans ISO 8601.

Note

Vous ne pouvez utiliser qu'au plus 3 décimales sur les secondes (bien qu'en réalité il n'y ait aucune valeur à fournir quoi que ce soit d'aussi précis). Si vous fournissez davantage, la charge utile n’est pas valide et vous recevrez la notification « Nouvelle notification ».

Conseils d’utilisation

En général, nous vous recommandons que la plupart des applications spécifient un horodatage personnalisé. Cela garantit que l’horodatage de la notification représente avec précision lorsque le message/information/contenu a été généré, quels que soient les retards réseau, le mode avion ou l’intervalle fixe des tâches en arrière-plan périodiques.

Par exemple, une application d’actualités peut exécuter une tâche en arrière-plan toutes les 15 minutes qui vérifie les nouveaux articles et affiche des notifications. Avant les horodatages personnalisés, l’horodatage correspond au moment où la notification d’application a été générée (par conséquent, toujours dans les intervalles de 15 minutes). Toutefois, l’application peut maintenant définir l’horodatage sur l’heure à laquelle l’article a été réellement publié. De même, les applications de messagerie et les applications de réseau social peuvent tirer parti de cette fonctionnalité si un modèle similaire d’extraction périodique est utilisé pour leurs notifications.

En outre, la fourniture d’un horodatage personnalisé garantit que l’horodatage est correct même si l’utilisateur a été déconnecté d’Internet. Par exemple, lorsque l’utilisateur active son ordinateur et que votre tâche en arrière-plan s’exécute, vous pouvez enfin vous assurer que l’horodatage sur vos notifications représente l’heure à laquelle les messages ont été envoyés, plutôt que l’heure à laquelle l’utilisateur a activé son ordinateur.

Horodatage par défaut

Si vous ne fournissez pas d’horodatage personnalisé, nous utilisons l’heure à laquelle votre notification a été envoyée.

Si vous avez envoyé une notification Push via WNS, nous utilisons l’heure à laquelle la notification a été reçue par le serveur WNS (par conséquent, toute latence lors de la remise de la notification à l’appareil n’aura pas d’impact sur l’horodatage).

Si vous avez envoyé une notification locale, nous utilisons l’heure à laquelle la plateforme de notification a reçu la notification (qui doit être immédiatement).

  • Last updated on