Contenu des notifications d’application

Les notifications d’application sont des notifications flexibles avec du texte, des images et des boutons/entrées. Cet article décrit les éléments d’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 pour une notification d’application.

Notes

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 progressivement retirer l’utilisation de la « notification toast » dans la documentation.

Prise en main

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 pour une notification d’application. Les exemples de code de cet article illustrent les trois méthodes :

  • Microsoft. API Windows.AppNotifications.Builder : introduit dans SDK d'application Windows 1.2, cet espace de noms fournit des API qui vous permettent de créer facilement la charge utile XML pour une notification par programmation 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 « SDK d'application Windows ».
  • Syntaxe Microsoft.Toolkit.Uwp.Notifications du générateur : 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 SDK d'application Windows applications et qu’elles continuent d’être prises en charge, nous recommandons que les nouvelles implémentations utilisent le Microsoft. API Windows.AppNotifications.Builder. Pour utiliser les API Community Toolkit, ajoutez le package nuget UWP Community Toolkit Notifications à 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 « Windows Community Toolkit ».
  • 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 ».

Installez Notifications Visualizer. Cette application Windows gratuite vous aide à concevoir des notifications d’application interactives en fournissant un aperçu visuel instantané de votre toast à mesure que vous le modifiez, comme l’éditeur XAML/mode création de Visual Studio. Pour plus d’informations, consultez Visualiseur de notifications ou téléchargez le visualiseur de notifications à partir du Store.

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

Structure de notification d’application

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

  • toast : l’attribut de lancement de cet élément définit les arguments qui seront renvoyés à votre application lorsque l’utilisateur clique sur votre toast, ce qui vous permet d’établir un lien profond vers le contenu correct affiché par le toast. Pour plus d’informations, consultez Envoyer une notification d’application locale.
  • visual : 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 affiché à 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 des étiquettes pour la zone d’attribution en haut montrant l’icône d’application et le nom de l’application Visualiseur notifications. La partie centrale du toast est étiquetée comme zone visuelle, qui comprend trois lignes de texte. La section inférieure du toast est étiquetée comme zone d’action et contient deux boutons intitulés Accepter et Refuser.

Zone d’attribution

La zone d’attribution se trouve en haut de la notification d’application. À compter 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 de points de suspension qui permet à l’utilisateur de désactiver rapidement les notifications pour votre application ou d’accéder à la page 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 contextuel de la zone d’attribution. Pour plus d’informations, consultez Actions du menu contextuel.

Visuels

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

Pour tous les attributs pris en charge dans la section visuelle et ses éléments enfants, consultez Schéma de notification d’application.

Éléments de texte

Chaque notification d’application doit avoir 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 avec trois lignes de texte. La ligne supérieure du texte est en gras.

Depuis la mise à jour anniversaire Windows 10, vous pouvez contrôler le nombre de lignes de texte affichées à l’aide de la propriété HintMaxLines sur le texte. La valeur par défaut (et le maximum) est de 2 lignes de texte maximum pour le titre, et jusqu’à 4 lignes (combinées) pour les deux éléments de description supplémentaires (les deuxième et 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 inline

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

Capture d’écran d’une notification d’application montrant l’emplacement par défaut de l’image, inline, 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

La spécification d’une valeur de placement « appLogoOverride » entraîne l’affichage de l’image dans un carré sur le côté gauche de la zone visuelle. Le nom de cette propriété reflète le comportement dans les versions précédentes de Windows, où l’image remplace l’image de logo d’application par défaut. Dans Windows 11, le logo de l’application s’affiche dans la zone d’attribution. Il n’est donc pas remplacé par le placement de l’image appLogoOverride.

Les dimensions de l’image sont de 48 x 48 pixels à une mise à l’é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 l’emplacement de l’image de remplacement du logo de l’application 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 d’indicateur

Microsoft recommandations de style recommandent de représenter les images de profil avec une image circulaire pour fournir une représentation cohérente des personnes entre 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 le placement de l’image de remplacement du logo de l’application rognée dans un cercle sur le côté gauche de la zone visuelle du 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 de héros

Nouveautés de la mise à jour anniversaire : les notifications d’application peuvent afficher une image de héros, qui est un ToastGenericHeroImage affiché en évidence dans la bannière toast et à l’intérieur du Centre de notifications. Les dimensions de l’image sont de 364 x 180 pixels à une mise à l’échelle de 100 %.

Capture d’écran d’une notification d’application montrant l’emplacement de l’image de héros, 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...

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

Pour les images web distantes http et https, la taille de fichier de chaque image individuelle est limitée. Dans fall Creators Update (16299), nous avons augmenté la limite à 3 Mo sur les connexions normales et à 1 Mo sur les connexions limitées. Avant cela, les images étaient toujours limitées à 200 Ko.

Connexion normale Connexion limitée Avant la mise à jour des créateurs d’automne
3 Mo 1 Mo 200 Ko

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

Texte d’attribution

Nouveautés de la mise à jour anniversaire : si vous devez référencer la source de votre contenu, vous pouvez utiliser le texte d’attribution. Ce texte est toujours affiché sous tous 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 faciliter la distinction des éléments de texte standard.

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

Capture d’écran d’une notification toast montrant le texte d’attribution « par 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"));

Horodatage personnalisé

Nouveautés de Creators Update : vous pouvez désormais remplacer l’horodatage fourni par le système par votre propre horodatage qui représente précisément quand le message/les informations/le contenu ont été générés. Cet horodatage 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 horodatage personnalisé, consultez horodatages 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és de Creators Update : vous pouvez fournir une barre de progression dans la notification de votre application pour tenir l’utilisateur informé 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, consultez Barre de progression toast.

headers

Nouveautés de Creators Update : vous pouvez regrouper des notifications sous des en-têtes dans le Centre de notifications. 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, ou plus encore.

Capture d’écran d’un centre de notifications 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, consultez En-têtes Toast.

Contenu adaptatif

Nouveautés de la mise à jour anniversaire : 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, dont vous pouvez en savoir plus en lisant la documentation vignettes adaptatives.

Notez que tout contenu adaptatif doit être contenu dans un AdaptiveGroup. Sinon, elle ne sera pas rendue à l’aide d’une méthode adaptative.

Colonnes et éléments de texte

Voici un exemple où des colonnes et des éléments de texte adaptatifs avancés sont utilisés. Étant donné que les éléments de texte se trouvent dans un AdaptiveGroup, ils prennent en charge toutes les propriétés de style adaptatives enrichies.

Capture d’écran d’une notification toast montrant des groupes d’éléments de texte 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 vos toasts interactifs, ce qui permet à l’utilisateur d’effectuer des actions rapides sur la notification de votre application sans interrompre son workflow actuel. 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, consultez Envoyer des toasts locaux.

Les boutons peuvent activer une application des manières suivantes :

  • L’application est activée au premier plan, avec un argument qui peut être utilisé pour accéder à une page/un contexte spécifique.
  • Une autre application est activée via le lancement du protocole.
  • L’activation en arrière-plan est prise en charge explicitement pour les applications UWP. Pour SDK d'application Windows applications, 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 passés s’il faut lancer entièrement l’application de premier plan ou simplement gérer la notification et quitter.
  • Les actions système, telles que le fait de répéter ou de fermer la notification, sont prises en charge à la fois pour les applications UWP et pour les SDK d'application Windows. Les API AppNotificationBuilder ne prennent pas en charge ce scénario, mais SDK d'application Windows applications peuvent implémenter ce scénario à l’aide de la Microsoft. API Windows.AppNotifications.Builder ou XML brut.

Notes

Vous ne pouvez avoir que 5 boutons (y compris les éléments de menu contextuel que nous aborderons plus tard).

Capture d’écran d’une notification toast montrant une ligne de texte suivie d’une ligne 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 à une mise à l’échelle de 100 %, et ne doivent pas avoir de remplissage inclus dans l’image elle-même. Si vous choisissez de fournir des icônes sur une notification toast, vous devez fournir des icônes pour TOUS vos boutons dans la notification, car cela transforme le style de vos boutons en boutons d’icône.

Notes

Pour l’accessibilité, veillez à inclure une version blanche contrastée de l’icône (une icône noire pour les arrière-plans blancs), afin que lorsque l’utilisateur active le mode Blanc à contraste élevé, votre icône soit visible. Pour plus d’informations, consultez Prise en charge des notifications par vignette et toast 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 Windows 11 Mise à jour : vous pouvez ajouter des info-bulles à vos icônes avec la propriété HintToolTip au format XML. Cela est idéal si vos boutons ont des icônes, mais aucun contenu, car cela vous permet de vous assurer que vous pouvez passer du texte que le Narrateur Windows peut lire. Toutefois, si du contenu est présent, le Narrateur lit le contenu, quel que soit ce qui est passé 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 des couleurs

Nouveauté de Windows 11 Mise à jour : 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 avec trois boutons, les deux boutons de gauche sont verts avec des icônes permettant de démarrer un appel vidéo ou de démarrer un appel audio. Le troisième bouton est rouge et a une icône pour 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 contextuel

Nouveauté de la mise à jour anniversaire : vous pouvez ajouter des actions de menu contextuel supplémentaires au menu contextuel existant qui s’affiche lorsque l’utilisateur clique avec le bouton droit sur votre notification toast ou sélectionne l’icône de menu contextuel.

Notes

Sur les appareils plus anciens, ces actions de menu contextuel supplémentaires s’affichent simplement en tant que boutons normaux sur votre notification.

Les actions de menu contextuel supplémentaires que vous ajoutez (telles que « Désactiver la conversation de groupe pendant 1 heure ») s’affichent au-dessus des deux entrées système par défaut.

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

Notes

D’autres éléments de menu contextuel 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 la même façon que les 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 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, puis référencez l’ID du champ d’entrée de texte afin que le bouton s’affiche en regard du champ d’entrée. L’icône facultative du bouton, si elle est fournie, doit être une image de 32 x 32 pixels sans remplissage, des pixels blancs définis sur transparents et une échelle de 100 %.

Capture d’écran d’une notification toast avec une image de profil et quelques lignes de texte. Une zone de texte permettant de taper directement dans le 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();

Entrées avec barre de boutons

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

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

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

Entrée de sélection

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 « Lunch » comme élément sélectionné, et une ligne avec deux boutons intitulé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());

Répéter/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 avec des lignes de texte décrivant l’heure et l’emplacement d’une réunion. Une zone de sélection a « 15 minutes » sélectionnée et des boutons intitulés Répéter et Ignorer sont sélectionnés.

Nous lisons le bouton Répéter à l’entrée du menu de sélection à l’aide de la propriété SelectionBoxId sur le bouton toast.

Microsoft. La syntaxe Windows.AppNotifications.Builder ne prend actuellement pas en charge l’activation du système. Toutefois, ce scénario est pris en charge pour les applications SDK d'application Windows, et vous pouvez créer des notifications pour ce scénario à l’aide Microsoft.Toolkit.Uwp.Notifications des API ou du code 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 le système répéter et ignorer les actions :

  • Spécifier un ToastButtonSnooze ou ToastButtonDismiss
  • Si vous le souhaitez, spécifiez une chaîne de contenu personnalisée :
  • Si vous ne fournissez pas de chaîne, nous utiliserons automatiquement des chaînes localisées pour « Répéter » et « Ignorer ».
  • Si vous le souhaitez, spécifiez SelectionBoxId :
  • Si vous ne voulez pas que l’utilisateur sélectionne un intervalle de répétition, mais souhaitez simplement que votre notification se répète une seule fois pendant un intervalle de temps défini par le système (et cohérent dans l’ensemble du système d’exploitation), ne construisez aucun élément <input>.
  • Si vous souhaitez fournir des sélections d’intervalles de répétition : - Spécifiez SelectionBoxId dans l’action de répétition - Faire correspondre l’ID de l’entrée à l’id SelectionBoxId de l’action répéter - Spécifiez la valeur de ToastSelectionBoxItem comme nonNegativeInteger qui représente l’intervalle de répétition en minutes.

Audio

L’audio personnalisé a toujours été pris en charge sur mobile et est pris en charge dans la version de bureau 1511 (build 10586) ou ultérieure. L’audio personnalisé peut être référencé via 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 des événements 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);

Consultez la page du schéma audio pour plus d’informations sur l’audio dans les notifications d’application. Pour savoir comment envoyer une notification d’application qui utilise de l’audio personnalisé, consultez l’audio personnalisé sur les toasts.

Scénarios

Pour créer des notifications, des alarmes, des rappels et des notifications d’appels entrants importants, il vous suffit d’utiliser une notification d’application normale avec une valeur de scénario qui lui est affectée. Le scénario ajuste quelques comportements pour créer une expérience utilisateur cohérente et unifiée. Il existe quatre valeurs de scénario possibles :

  • Rappel
  • Alarme
  • IncomingCall
  • Urgent

Rappels

Dans le scénario de rappel, la notification reste à l’écran jusqu’à ce que l’utilisateur la ignore ou prenne des mesures. Sur Windows Mobile, la notification d’application s’affiche également pré-développée. Un son de rappel sera lu. Vous devez fournir au moins un bouton sur la notification de votre application. Sinon, la notification sera traitée comme une notification normale.

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

Alarmes

Les alarmes se comportent de la même façon que les rappels, sauf que les alarmes sont également en boucle avec un son d’alarme par défaut. Vous devez fournir au moins un bouton sur la notification de votre application. Sinon, la notification sera traitée comme une notification normale.

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

Appels entrants

Les notifications d’appel entrantes sont affichées pré-développées dans un format d’appel spécial et restent sur l’écran de l’utilisateur jusqu’à ce qu’elles soient ignorées. L’audio de sonnerie est en boucle par défaut. Sur les appareils Windows Mobile, ils 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

Requis : vous devez exécuter Windows Insider Preview build 22546 ou une version ultérieure pour utiliser des notifications importantes.

Les notifications importantes permettent aux utilisateurs d’avoir plus de contrôle sur les applications tierces et tierces qui peuvent leur envoyer des notifications d’application de priorité élevée (urgentes/importantes) qui peuvent passer par l’assistant de focus (ne pas déranger). Cela peut être modifié dans les paramètres de notifications.

Capture d’écran d’une notification d’application urgente qui a un point d’exclamation dans la zone d’attribution en regard du nom de l’application. L’image montre également la notification d’application lancée par le système qui fournit des boutons permettant à l’utilisateur d’autoriser ou d’interdire 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’application 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 plus d’informations, consultez Prise en charge des notifications par vignette et toast 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 qui clique sur votre toast ou sur vos boutons), consultez Envoyer une toast locale.