Partager via


Contenu des notifications d’application

Les notifications d’applications sont des notifications flexibles avec du texte, des images et des boutons/entrées. Le présent article décrit les éléments de l’interface utilisateur qui peuvent être utilisés dans une notification d’application et fournit des exemples de code pour générer le format XML d’une notification d’application.

Remarque

Le terme « notification toast » est remplacé par « notification d’application ». Ces termes font tous deux référence à la même fonctionnalité de Windows, mais au fil du temps, nous allons effectuer une phase d’utilisation de la « notification toast » dans la documentation.

Mise en route

Les notifications d’application sont définies avec une charge utile XML définie par le schéma de notification d’application. Actuellement, il existe trois façons de générer la charge utile XML d’une notification d’application. Les exemples de code présentés dans cet article illustrent ces trois méthodes :

  • API Microsoft.Windows.AppNotifications.Builder – Introduit dans le kit SDK d’application Windows 1.2, cet espace de noms fournit des API qui vous permettent de construire facilement la charge utile XML d’une notification de manière programmatique sans avoir à vous soucier des spécificités du format XML. Les exemples de code utilisant ces API se trouvent dans les onglets intitulés « kit SDK d’application Windows ».
  • Syntaxe du générateur Microsoft.Toolkit.Uwp.Notifications : ces API font partie du kit de ressources de la communauté UWP et prennent en charge les applications UWP. Bien que ces API puissent également être utilisées pour les applications du kit SDK d’application Windows et qu’elles continuent d’être prises en charge, nous recommandons que les nouvelles implémentations utilisent les API Microsoft.Windows.AppNotifications.Builder. Pour utiliser les kits de ressources de la communauté UWP, ajoutez le package nuget notifications de la communauté UWP à votre projet. Les exemples C# fournis dans cet article utilisent la version 7.0.0 du package NuGet. Les exemples de code utilisant ces API se trouvent dans les onglets intitulés « kit de ressources de la communauté Windows ».
  • XML brut : si vous préférez, vous pouvez créer votre propre code personnalisé pour générer des chaînes XML au format requis. Les exemples XML bruts se trouvent dans les onglets intitulés « XML ».

Installer un visualiseur de notifications. Cette application Windows gratuite vous permet de concevoir des notifications d’application interactives en fournissant un aperçu visuel instantané de votre toast lorsque vous la modifiez, comme l’éditeur XAML/le mode Création de Visual Studio. Pour en savoir plus, reportez-vous à Visualiseur de notifications ou téléchargez le visualiseur de notifications à partir de Store.

Cet article traite uniquement de la création du contenu de notification d’application. Pour en savoir plus sur l’envoi d’une notification après avoir généré la charge utile XML, reportez-vous à Envoyer une notification d’application locale.

Structure de notification d’application

Voici quelques composants importants et généraux d’une charge utile XML de notification d’application :

  • toast : l’attribut de lancement de cet élément définit les arguments qui seront transmis à votre application lorsque l’utilisateur clique sur votre toast, ce qui vous permet de de créer un lien profond vers le bon contenu affiché par le toast. Pour en savoir plus, reportez-vous à Envoyer une notification d’application locale.
  • visuel : cet élément représente une partie visuelle du toast, y compris la liaison générique qui contient du texte et des images.
  • actions : cet élément représente une partie interactive du toast, y compris les entrées et les actions.
  • audio : cet élément spécifie l’audio lu lorsque le toast est présenté à l’utilisateur.
var builder = new AppNotificationBuilder()
    .AddArgument("conversationId", "9813")

    .AddText("Some text")

    .AddButton(new AppNotificationButton("Archive")
        .AddArgument("action", "archive"))

    .SetAudioUri(new Uri("ms-appx:///Sound.mp3"));

Voici une représentation visuelle du contenu de la notification d’application :

Capture d’écran d’une notification d’application avec les étiquettes de la zone d’attribution en haut montrant l’icône de l’application et et le nom de l’application Notifications Visualizer. La partie centrale de la notification toast est étiquetée comme la zone visuelle, qui comprend trois lignes de texte. La partie inférieure de la notification toast est appelée zone d’action et contient deux boutons intitulés Accepter et Refuser.

Zone d’attribution

La zone d’attribution se trouve dans la partie supérieure de la notification de l’application. À partir de Windows 11, le nom et l’icône de votre application s’affichent dans cette zone. La zone d’attribution comprend également un bouton Fermer qui permet à l’utilisateur d’ignorer rapidement la notification et un menu ellipses qui lui permet de désactiver rapidement les notifications de votre application ou d’accéder à la page des paramètres Windows pour les notifications de votre application. La zone d’attribution est configurée par l’interpréteur de commandes et ne peut pas être remplacée dans la charge utile XML toast, bien que votre application puisse ajouter des éléments au menu local de la zone d’attribution. Pour en savoir plus, reportez-vous à Actions du menu contextuel.

Visuels

Chaque notification d’application doit spécifier un élément visuel, pour lequel vous devez fournir une liaison de toast générique et qui peut contenir du texte et des images. Ces éléments seront affichés sur les différents appareils Windows, y compris les ordinateurs de bureau, les téléphones, les tablettes et la Xbox.

Pour connaître tous les attributs pris en charge dans la section visuelle et ses éléments enfants, reportez-vous au schéma des notifications d’applications.

Éléments de texte

Chaque notification d’app doit comporter au moins un élément de texte, et peut contenir deux éléments de texte supplémentaires, tous de type AdaptiveText.

Capture d’écran d’une notification d’application comportant trois lignes de texte. La première ligne de texte est en gras.

Depuis la mise à jour anniversaire Windows 10, vous pouvez contrôler le nombre de lignes de texte affichées en utilisant la propriété HintMaxLines sur le texte. La valeur par défaut (et maximale) est jusqu’à 2 lignes de texte pour le titre, et jusqu’à 4 lignes (combinées) pour les deux éléments de description supplémentaires (le deuxième et le troisième AdaptiveText).

var builder = new AppNotificationBuilder()
    .AddArgument("conversationId", 9813)
    .AddText("Adaptive Tiles Meeting", new AppNotificationTextProperties().SetMaxLines(1))
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

Image incorporée

Par défaut, les images sont affichées en ligne, après tout élément de texte, sur toute la largeur de la zone visuelle.

Capture d’écran d’une application de notification montrant l’emplacement de l’image par défaut, en ligne, remplissant toute la largeur de la zone visuelle.

var builder = new AppNotificationBuilder()
    .AddText("Featured image of the day.")
    .SetInlineImage(new Uri("ms-appx:///Images/InlineImage.png"));

AppNotificationManager.Default.Show(builder.BuildNotification());

Remplacement du logo de l’application

Si la valeur de placement est « appLogoOverride », l’image sera affichée dans un carré sur le côté gauche de la zone visuelle. Le nom de cette propriété reflète le comportement des versions précédentes de Windows, où l’image remplaçait l’image du logo de l’application par défaut. Dans Windows 11, le logo de l’application est affiché dans la zone d’attribution et n’est donc pas remplacé par l’image appLogoOverride.

Les dimensions de l’image sont de 48 x 48 pixels à une échelle de 100 %. Nous vous recommandons généralement de fournir une version de chaque ressource d’icône pour chaque facteur d’échelle : 100 %, 125 %, 150 %, 200 % et 400 %.

Capture d’écran d’une notification d’application montrant le remplacement du logo de l’application par une image dans un carré sur le côté gauche de la zone visuelle de la notification.

var builder = new AppNotificationBuilder()
    .AddText("Featured image of the day.")
    .SetAppLogoOverride(new Uri("ms-appx:///Images/AppLogo.png"));

Rognage de l’indicateur

Le guide de style de Microsoft recommande de représenter les avatars par une image circulaire afin d’assurer une représentation cohérente des personnes à travers les applications et l’interpréteur de commandes. Définissez la propriété HintCrop sur Circle pour afficher l’image avec un rognage circulaire.

Capture d’écran d’une notification d’application montrant l’emplacement de l’image de remplacement du logo de l’application dans un cercle sur le côté gauche de la zone visuelle du message toast.

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetAppLogoOverride(new Uri("ms-appx:///Images/Profile.png"), AppNotificationImageCrop.Circle);

Image Hero

Nouveauté de la mise à jour Anniversary Update : les notifications d’applications peuvent afficher une image de héros, qui est une ToastGenericHeroImage mise en évidence dans la bannière de toast et dans le centre de notifications. Les dimensions de l’image sont de 364 x 180 pixels à une échelle de 100 %.

Capture d’écran d’une notification d’application montrant l’emplacement de l’image principale, au-dessus de la zone d’attribution.

var builder = new AppNotificationBuilder()
    .AddText("Marry Anne")
    .AddText("Check out where we camped last night!")
    .SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"));

Restrictions de taille d’image

Les images que vous utilisez dans votre notification toast peuvent provenir de...

  • http://
  • ms-appx:///
  • ms-appdata:///

Pour les images web http et https distantes, il existe des limites sur la taille de fichier de chaque image individuelle. Dans la mise à jour Fall Creators Update (16299), nous avons augmenté la limite à 3 Mo pour les connexions normales et à 1 Mo pour les connexions avec compteur. Jusqu’à présent, les images se limitaient toujours à 200 Ko.

Connexion normale Connexion limitée Avant Fall Creators Update
3 Mo 1 Mo 200 Ko

Si une image dépasse la taille du fichier, ou ne parvient pas à télécharger ou expire, l’image est supprimée et le reste de la notification s’affiche.

Texte d’attribution

Nouveauté de la mise à jour Anniversary Update : si vous devez indiquer la source de votre contenu, vous pouvez utiliser un texte d’attribution. Ce texte s’affiche toujours sous les éléments de texte, mais au-dessus des images incorporées. Le texte utilise une taille légèrement plus petite que les éléments de texte standard pour faire la distinction entre les éléments de texte standard.

Sur les versions antérieures de Windows qui ne prennent pas en charge le texte d’attribution, le texte s’affiche simplement en tant qu’autre élément de texte (en supposant que vous n’avez pas déjà le maximum de trois éléments de texte).

Capture d’écran d’une notification toast montrant le texte d’attribution « via SMS » sous les autres lignes de texte dans la zone visuelle du toast.

var builder = new AppNotificationBuilder()
    .AddText("Marry Anne")
    .AddText("Check out where we camped last night!")
    .SetAttributionText("via SMS");
    .SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"));

Horodateur personnalisé

Nouveauté de la mise à jour Creators Update : vous pouvez désormais remplacer l’horodateur fourni par le système par votre propre horodateur qui représente avec précision le moment où le message/information/contenu a été généré. Cet horodateur est visible dans le Centre de notifications.

Capture d’écran d’une notification dans le Centre de notifications avec un horodatage personnalisé.

Pour en savoir plus sur l’utilisation d’un horodateur personnalisé, reportez-vous aux horodateurs personnalisés sur les toasts.

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));

Barre de progression

Nouveauté de la mise à jour Creators Update : vous pouvez fournir une barre de progression sur votre notification d’application pour informer l’utilisateur de la progression des opérations telles que les téléchargements.

Capture d’écran d’une notification toast montrant une barre de progression.

Pour en savoir plus sur l’utilisation d’une barre de progression, reportez-vous à la barre de progression toast.

En-têtes

Nouveauté de la mise à jour Creators Update : vous pouvez regrouper les notifications sous les en-têtes dans le Centre de notification. Par exemple, vous pouvez regrouper les messages d’une conversation de groupe sous un en-tête, ou regrouper les notifications d’un thème commun sous un en-tête, etc.

Capture d’écran d’un centre d’action montrant plusieurs notifications pour l’application Notifications Viewer organisées sous un en-tête intitulé « Camping ! ».

Pour en savoir plus sur l’utilisation des en-têtes, reportez-vous aux en-têtes Toast.

Contenu adaptatif

Nouveauté de la mise à jour Anniversary Update : en plus du contenu spécifié ci-dessus, vous pouvez également afficher du contenu adaptatif supplémentaire visible lorsque le toast est développé.

Ce contenu supplémentaire est spécifié à l’aide d’Adaptive, que vous pouvez découvrir en lisant la documentation sur la documentation des vignettes adaptatives.

Notez que tout contenu adaptatif doit être contenu dans un AdaptiveGroup. Dans le cas contraire, il ne sera pas rendu en utilisant Adaptive.

Colonnes et éléments de texte

Voici un exemple d’utilisation de colonnes et d’éléments textuels adaptatifs avancés. Étant donné que les éléments de texte font partie d’un AdaptiveGroup, ils prennent en charge toutes les propriétés de style adaptatif.

Capture d’écran d’une notification toast montrant des groupes d’éléments textuels alignés à gauche et à droite de la zone visuelle du toast.

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support adaptive text elements.

Boutons

Les boutons rendent votre toast interactif, permettant à l’utilisateur d’effectuer des actions rapides sur la notification de votre application sans interrompre son flux de travail. Par exemple, les utilisateurs peuvent répondre à un message directement à partir d’un toast, ou supprimer un e-mail sans même ouvrir l’application de messagerie. Les boutons apparaissent dans la partie développée de votre notification.

Pour en savoir plus sur l’implémentation de boutons de bout en bout, reportez-vous à la rubrique Envoyer un toast local.

Les boutons peuvent activer une application de la manière suivante :

  • L’application est activée au premier plan, avec un argument qui peut être utilisé pour naviguer vers une page/un contexte spécifique.
  • Une autre application est activée lors du lancement d’un protocole.
  • L’activation en arrière-plan est prise en charge explicitement pour les applications UWP. Pour les applications du kit SDK d’application Windows, l’application est toujours lancée au premier plan. L’application peut appeler AppInstance.GetActivatedEventArgs pour détecter si l’activation a été lancée par une notification et déterminer, à partir des arguments transmis, s’il faut lancer complètement l’application au premier plan ou se contenter de gérer la notification et de quitter.
  • Les actions système, telles que la mise en veille ou le rejet de la notification, sont prises en charge à la fois pour les applications UWP et pour le kit SDK d’application Windows. Les API AppNotificationBuilder ne prennent pas en charge ce scénario, mais les applications de kit SDK d’application Windows peuvent l’implémenter en utilisant les API Microsoft.Windows.AppNotifications.Builder ou du XML brut.

Remarque

Vous ne disposez que de 5 boutons au plus (y compris les éléments du menu contextuel dont nous parlerons plus tard).

Capture d’écran d’une notification toast montrant une ligne de texte suivie d’une rangée avec deux boutons définis par des éléments d’action.

new ToastContentBuilder()
    var builder = new AppNotificationBuilder()
        .AddText("New product in stock!")
        .AddButton(new AppNotificationButton("See more details")
            .AddArgument("action", "viewDetails"))
            .AddArgument("contentId", "351")
        .AddButton(new AppNotificationButton("Remind me later")
            .AddArgument("action", "remindLater"))
            .AddArgument("contentId", "351");

Boutons avec icônes

Vous pouvez ajouter des icônes à vos boutons. Ces icônes sont des images blanches transparentes de 16 x 16 pixels à 100 % d’échelle, et ne doivent pas avoir de remplissage inclus dans l’image elle-même. Si vous choisissez de fournir des icônes dans une notification toast, vous devez fournir des icônes pour TOUS vos boutons dans la notification, car le style de vos boutons est transformé en boutons-icônes.

Remarque

Pour des raisons d’accessibilité, veillez à inclure une version en contraste blanc de l’icône (une icône noire pour les arrière-plans blancs), afin que votre icône soit visible lorsque l’utilisateur active le mode Blanc à contraste élevé. Pour en savoir plus, reportez-vous à Prise en charge des notifications de vignettes et toasts pour la langue, la mise à l’échelle et le contraste élevé.

Capture d’écran d’une notification d’application qui utilise des boutons avec des icônes.

new ToastContentBuilder()
    var builder = new AppNotificationBuilder()
        .AddText("Return books to the library.")
        .AddButton(new AppNotificationButton("Accept")
            .AddArgument("action", "accept")
            .SetIcon(new Uri("ms-appx:///Images/Accept.png")))
        .AddButton(new AppNotificationButton("Snooze")
            .AddArgument("action", "snooze")
            .SetIcon(new Uri("ms-appx:///Images/Snooze.png")))
        .AddButton(new AppNotificationButton("Dismiss")
            .AddArgument("action", "dismiss")
            .SetIcon(new Uri("ms-appx:///Images/Dismiss.png")));

Nouveauté de la mise à jour Windows 11 Update : vous pouvez ajouter des info-bulles à vos icônes avec la propriété HintToolTip dans XML. Cette fonctionnalité est idéale si vos boutons ont des icônes mais pas de contenu, car elle vous permet de passer du texte que Narrateur Windows peut lire. Cependant, si le contenu s’affiche, le Narrateur le lira, peu importe ce qui est transmis dans l’info-bulle.

var button = new AppNotificationButton("Reply")
    .AddArgument("action", "reply");

if (AppNotificationButton.IsToolTipSupported())
{
    button.ToolTip = "Click to reply.";
}

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .AddButton(button); 

Boutons avec couleurs

Nouveauté de la mise à jour Windows 11 Update : vous pouvez ajouter des couleurs rouges ou vertes à vos boutons en ajoutant l’attribut useButtonStyle à l’élément XML toast et l’attribut hint-buttonStyle à l’élément XML d’action comme indiqué ci-dessous.

Capture d’écran d’une notification comportant trois boutons. Les deux boutons de gauche sont verts et comportent des icônes permettant de lancer un appel vidéo ou un appel audio. Le troisième bouton est rouge et comporte une icône permettant de rejeter l’appel.

var builder = new AppNotificationBuilder()
    .SetScenario(AppNotificationScenario.IncomingCall)
    .AddText("Andrew Bares", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .AddText("Incoming Call - Mobile", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .SetInlineImage(new Uri("ms-appx:///Images/Profile.png"),
        AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton()
        .SetToolTip("Answer Video Call")
        .SetButtonStyle(AppNotificationButtonStyle.Success)
        .SetIcon(new Uri("ms-appx:///Images/Video.png"))
        .AddArgument("videoId", "123"))
    .AddButton(new AppNotificationButton()
        .SetToolTip("Answer Phone Call")
        .SetButtonStyle(AppNotificationButtonStyle.Success)
        .SetIcon(new Uri("ms-appx:///Images/Call.png"))
        .AddArgument("callId", "123"))
    .AddButton(new AppNotificationButton()
        .SetToolTip("Hang Up")
        .SetButtonStyle(AppNotificationButtonStyle.Critical)
        .SetIcon(new Uri("ms-appx:///Images/HangUp.png"))
        .AddArgument("hangUpId", "123"));

Actions du menu local

Nouveauté de la mise à jour Anniversary Update : vous pouvez ajouter des actions supplémentaires au menu local existant qui apparaît lorsque l’utilisateur clique avec le bouton droit sur votre notification toast ou sélectionne l’icône du menu local.

Remarque

Sur les appareils plus anciens, ces actions de menu local supplémentaires apparaîtront simplement comme des boutons normaux sur votre notification.

Les actions de menu local supplémentaires que vous ajoutez (telles que « Couper le son de la conversation de groupe pendant 1 heure ») apparaissent au-dessus des deux entrées système par défaut.

Notification toast avec menu contextuel

var builder = new AppNotificationBuilder()
    .AddText("Camping this weekend?")
    .SetAppLogoOverride(new Uri("ms-appx:///images/Reply.png"), AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton("Mute group chat for 1 hour")
        .AddArgument("action", "mute")
        .SetContextMenuPlacement());

Remarque

Les éléments de menu contextuel supplémentaires contribuent à la limite totale de 5 boutons sur un toast.

L’activation d’éléments de menu contextuel supplémentaires est gérée de manière identique aux boutons toast.

Entrées

Les entrées sont spécifiées dans la région Actions de la notification d’application, ce qui signifie qu’elles ne sont visibles que lorsque la notification est développée.

Zone de texte de réponse rapide

Pour activer une zone de texte de réponse rapide (par exemple, dans une application de messagerie), ajoutez une entrée de texte et un bouton, et faites référence à l’ID du champ de saisie de texte pour que le bouton soit affiché à côté du champ de saisie. L’icône facultative du bouton, si elle est fournie, doit être une image de 32 x 32 pixels sans remplissage, avec des pixels blancs transparents et une échelle de 100 %.

Capture d’écran d’une notification toast avec une photo de profil et quelques lignes de texte. Une zone de texte permettant de taper directement dans la notification toast est incluse, ainsi qu’un bouton pour envoyer la réponse.

var builder = new AppNotificationBuilder()
    .AddTextBox("textBox", "Type a reply", "Reply")
    .AddButton(AppNotificationButton("Send")
        .AddArguments("action", "Send")
        .SetInputId("textBox"))
    .BuildNotification();

Champs de saisie avec barre de boutons

Vous pouvez également avoir une (ou plusieurs) entrée(s) avec des boutons normaux affichés sous les entrées.

Capture d’écran d’une notification d’application présentant une ligne de texte, une zone de texte et une rangée de deux boutons intitulés « Répondre » et « Appel vidéo ».

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support quick reply text boxes.

Sélectionner une entrée

En plus des zones de texte, vous pouvez également utiliser un menu de sélection.

Capture d’écran d’une notification d’application montrant une ligne de texte, une entrée de sélection avec « Déjeuner » comme élément sélectionné, et une ligne avec deux boutons étiquetés « Réserver » et « Appeler le restaurant ».

var builder = new AppNotificationBuilder()
    .AddText("4th coffee?")
    .AddText("When do you plan to come in tomorrow?")
    .AddComboBox(new AppNotificationComboBox("time")
        .SetTitle("Select an item:")
        .AddItem("breakfast", "Breakfast")
        .AddItem("lunch", "Lunch")
        .AddItem("dinner", "Dinner")
        .SetSelectedItem("lunch"))
    .AddButton(new AppNotificationButton("Reply")
        .AddArgument("action", "reply")
        .AddArgument("threadId", "9218")
        .SetContextMenuPlacement())
    .AddButton(new AppNotificationButton("Call restaurant")
        .AddArgument("action", "videocall")
        .AddArgument("threadId", "9218")
        .SetContextMenuPlacement());

Désactiver temporairement ou ignorer

À l’aide d’un menu de sélection et de deux boutons, nous pouvons créer une notification de rappel qui utilise les actions de répétition et de rejet du système. Veillez à définir le scénario sur « Rappel » pour que la notification se comporte comme un rappel.

Capture d’écran d’une notification d’application présentant des lignes de texte décrivant l’heure et le lieu d’une réunion. Une boîte de sélection contient « 15 minutes » et des boutons intitulés « répétition » et « ignorer »

Nous lions le bouton de désactivation temporaire à l’entrée du menu de sélection à l’aide de la propriété SelectionBoxId du bouton toast.

La syntaxe Microsoft.Windows.AppNotifications.Builder ne prend pas actuellement en charge l’activation du système. Cependant, ce scénario est pris en charge pour les applications du kit SDK d’application Windows, et vous pouvez générer des notifications pour ce scénario en utilisant les API Microsoft.Toolkit.Uwp.Notifications ou le XML brut.

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support system activation. 
// But this scenario is supported for Windows App SDK apps, and you can build notifications for this 
// scenario using the `Microsoft.Toolkit.Uwp.Notifications` APIs or raw XML.

Pour utiliser les actions de désactivation temporaire et de refus du système :

  • Spécifiez un ToastButtonSnooze ou ToastButtonDismiss
  • Le cas échéant, spécifiez une chaîne de contenu d’utilisateur :
  • Si vous ne fournissez pas de chaîne, nous allons utiliser automatiquement des chaînes localisées pour « Désactiver temporairement » et « Ignorer ».
  • Le cas échéant, spécifiez le SelectionBoxId :
  • Si vous ne souhaitez pas que l’utilisateur sélectionne un intervalle de désactivation temporaire et que vous voulez simplement que votre notification ne soit répétée qu’une seule fois pendant un intervalle de temps défini par le système (qui est cohérent dans l’ensemble du système d’exploitation), ne générez aucune <entrée >.
  • Si vous souhaitez proposer des sélections d’intervalles de désactivation temporaire : - Spécifiez SelectionBoxId dans l’action snooze ; - Faites correspondre l’identifiant de l’entrée avec SelectionBoxId de l’action de désactivation temporaire ; - Spécifiez que la valeur de ToastSelectionBoxItem est un nombre non négatif qui représente l’intervalle de désactivation temporaire en minutes.

Audio

L’audio personnalisé a toujours été pris en charge sur Mobile et l’est également dans la version 1511 (version 10586) ou ultérieure pour ordinateur de bureau. Les fichiers audio personnalisés peuvent être référencés par les chemins suivants :

  • ms-appx:///
  • ms-appdata:///
var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"));

Vous pouvez également choisir dans la liste ms-winsoundevents, qui ont toujours été pris en charge sur les deux plateformes.

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioEvent(AppNotificationSoundEvent.Alarm, AppNotificationAudioLooping.Loop);

Reportez-vous à la page de schéma audio pour en savoir plus sur les notifications audio dans l’application. Pour savoir comment envoyer une notification d’application qui utilise un audio personnalisé, reportez-vous à l’audio l’audio personnalisé sur les toasts.

Scénarios

Pour créer des notifications importantes, des alarmes, des rappels et des notifications d’appels entrants, il suffit d’utiliser une notification d’application normale à laquelle une valeur de scénario est attribuée. Le scénario ajuste quelques comportements pour créer une expérience utilisateur cohérente et unifiée. Quatre valeurs de scénario sont possibles :

  • Rappel
  • Alarme
  • IncomingCall
  • Urgent

Relances

Dans le scénario de rappel, la notification reste affichée à l’écran jusqu’à ce que l’utilisateur la désactive ou agisse. Sous Windows Mobile, la notification de l’application s’affichera également en mode aperçu. Un son de rappel sera émis. Vous devez fournir au moins un bouton sur votre notification d’application. Sinon, la notification sera traitée comme toute autre notification.

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetScenario(AppNotificationScenario.Reminder);

Alarmes

Les alarmes se comportent comme les rappels, sauf qu’elles émettent en plus un son en boucle avec un son d’alarme par défaut. Vous devez fournir au moins un bouton sur votre notification d’application. Sinon, la notification sera traitée comme toute autre notification.

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetScenario(AppNotificationScenario.Alarm)
    .AddButton(new AppNotificationButton("Dismiss")
        .AddArgument("action", "dismiss"));

Appels entrants

Les notifications d’appels entrants s’affichent en mode aperçu dans un format d’appel spécial et restent sur l’écran de l’utilisateur jusqu’à ce qu’il les ignore. La sonnerie passe en boucle par défaut. Sur les appareils mobiles Windows, elles s’affichent en plein écran.

Notification toast d’appel entrant

var builder = new AppNotificationBuilder()
    .SetScenario(AppNotificationScenario.IncomingCall)
    .AddText("Andrew Bares", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
    .AddText("incoming call - mobile", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .SetInlineImage(new Uri("ms-appx:///images/profile.png"),
        AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton("Text reply")
        .SetToolTip("Text reply")
        .SetIcon(new Uri("ms-appx:///images/reply.png"))
        .AddArgument("textId", "123"))
    .AddButton(new AppNotificationButton("Reminder")
        .SetToolTip("Reminder")
        .SetIcon(new Uri("ms-appx:///images/reminder.png"))
        .AddArgument("reminderId", "123"))
    .AddButton(new AppNotificationButton("Ignore")
        .SetToolTip("Ignore")
        .SetIcon(new Uri("ms-appx:///images/ignore.png"))
        .AddArgument("ignoreId", "123"))
    .AddButton(new AppNotificationButton("Answer")
        .SetToolTip("Answer")
        .SetIcon(new Uri("ms-appx:///images/answer.png"))
        .AddArgument("answerId", "123"));

Notifications importantes

Important

Conditions requises : vous devez exécuter Windows Insider Preview, version 22546 ou ultérieure, pour utiliser les notifications importantes.

Les notifications importantes permettent aux utilisateurs de mieux contrôler les applications internes et tierces qui peuvent leur envoyer des notifications d’applications de haute priorité (urgentes/importantes) qui peuvent passer à travers l’assistant de concentration (Ne pas déranger). Ce paramètre peut être modifié dans les paramètres de notification.

Capture d’écran d’une notification d’application urgente comportant un point d’exclamation dans la zone d’attribution, à côté du nom de l’application. L’image montre également la notification d’application initiée par le système qui fournit des boutons permettant à l’utilisateur d’autoriser ou non les notifications urgentes de l’application.

var builder = new AppNotificationBuilder()
    .AddText("Adaptive Tiles Meeting", 
        new AppNotificationTextProperties()
            .SetMaxLines(1))
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

if (AppNotificationBuilder.IsUrgentScenarioSupported())
{
    builder.SetScenario(AppNotificationScenario.Urgent);
}

Localisation et accessibilité

Vos vignettes et notifications d’applis peuvent charger des chaînes et des images adaptées à la langue d’affichage, au facteur d’échelle d’affichage, au contraste élevé et à d’autres contextes d’exécution. Pour en savoir plus, reportez-vous à Prise en charge des notifications de vignettes et toasts pour la langue, la mise à l’échelle et le contraste élevé.

Gestion de l’activation

Pour savoir comment gérer les activations d’applications (l’utilisateur cliquant sur votre toast ou sur les boutons du toast), reportez-vous à Envoyer un toast local.