Utiliser des notifications d’application avec une application UWP

Une notification d’application est une fenêtre contextuelle d’interface utilisateur qui s’affiche en dehors de la fenêtre de votre application, en fournissant des informations ou des actions en temps opportun à l’utilisateur. Les notifications peuvent être purement informationnelles, peuvent lancer votre application quand un clic est activé ou déclencher une action en arrière-plan sans amener votre application au premier plan.

Capture d’écran d’une notification d’application

Cet article vous guide tout au long des étapes de création et d’envoi d’une notification d’application à partir d’une application UWP, puis gère l’activation lorsque l’utilisateur interagit avec lui.

Pour obtenir une vue d’ensemble des notifications d’application et des conseils pour d’autres infrastructures, consultez la vue d’ensemble des notifications d’application.

Cet article traite des notifications locales. Pour plus d’informations sur la remise de notifications à partir d’un service cloud, consultez la vue d’ensemble des notifications Push.

Prerequisites

  • Un projet d’application UWP dans Visual Studio
  • Charge de travail plateforme Windows universelle installée dans Visual Studio

Envoyer une notification d’application

Les applications UWP utilisent l’espace de noms Windows.UI.Notifications pour construire et envoyer des notifications à l’aide de XML. Cette section montre comment envoyer des notifications à l’aide de C# et C++.

using Windows.Data.Xml.Dom;
using Windows.UI.Notifications;

var xml = @"<toast launch=""action=viewConversation&amp;conversationId=9813"">
    <visual>
        <binding template=""ToastGeneric"">
            <text>Andrew sent you a picture</text>
            <text>Check this out, The Enchantments in Washington!</text>
        </binding>
    </visual>
</toast>";

var doc = new XmlDocument();
doc.LoadXml(xml);

var notification = new ToastNotification(doc);
ToastNotificationManager.CreateToastNotifier().Show(notification);

Gérer l’activation

Lorsque l’utilisateur clique sur votre notification (ou un bouton sur la notification avec activation au premier plan), la méthode de OnActivated votre application est appelée. OnLaunched n’est pas appelé pour les activations de notification, même si votre application a été fermée et est lancée pour la première fois. Nous vous recommandons de combiner OnLaunched et OnActivated dans une méthode d'initialisation partagée.

App.xaml.cs

protected override void OnLaunched(LaunchActivatedEventArgs e)
{
    OnLaunchedOrActivated(e.PreviousExecutionState);

    var rootFrame = Window.Current.Content as Frame;
    if (e.PrelaunchActivated == false)
    {
        if (rootFrame?.Content == null)
        {
            rootFrame?.Navigate(typeof(MainPage), e.Arguments);
        }
        Window.Current.Activate();
    }
}

protected override void OnActivated(IActivatedEventArgs e)
{
    OnLaunchedOrActivated(e.PreviousExecutionState);

    if (e is ToastNotificationActivatedEventArgs toastArgs)
    {
        var rootFrame = Window.Current.Content as Frame;
        if (rootFrame?.Content == null)
        {
            rootFrame?.Navigate(typeof(MainPage));
        }
        Window.Current.Activate();

        // Parse the notification arguments
        string argument = toastArgs.Argument;
        // TODO: Navigate to the relevant content based on the arguments
    }
}

private void OnLaunchedOrActivated(ApplicationExecutionState previousState)
{
    if (Window.Current.Content is not Frame)
    {
        var rootFrame = new Frame();
        rootFrame.NavigationFailed += OnNavigationFailed;
        Window.Current.Content = rootFrame;
    }
}

Pour plus d’informations sur l’ajout de boutons, d’images, d’entrées, d’audio et d’autres contenus enrichis à vos notifications, consultez le contenu de notification d’application.

Contenu connexe

  • Last updated on