Encabezados de notificaciones de app

Puede agrupar visualmente un conjunto de notificaciones relacionadas en el Centro de notificaciones agregando un encabezado a las notificaciones.

En el ejemplo que se muestra a continuación, esta conversación de grupo se unifica bajo un único encabezado, "Camping!!". Cada mensaje individual de la conversación es una notificación de aplicación independiente que comparte el mismo encabezado.

Notificaciones con encabezado

También puede agrupar visualmente las notificaciones por categoría, como recordatorios de vuelos, seguimiento de paquetes, etc.

Para obtener más información sobre las notificaciones de la aplicación, consulte Introducción a las notificaciones de aplicaciones.

Agregar un encabezado a una notificación

Nota:

AppNotificationBuilder no incluye actualmente un SetHeader método, por lo que usa la carga XML directamente con el constructor AppNotification .

using Microsoft.Windows.AppNotifications;

string xml = @"
<toast>
    <header id='6289' title='Camping!!' arguments='action=openConversation&amp;id=6289'/>
    <visual>
        <binding template='ToastGeneric'>
            <text>Anyone have a sleeping bag I can borrow?</text>
        </binding>
    </visual>
</toast>";

var notification = new AppNotification(xml);
AppNotificationManager.Default.Show(notification);

Para agrupar varias notificaciones en el mismo encabezado, use el mismo identificador de encabezado en cada notificación. El identificador es la única propiedad que se usa para determinar la agrupación: el título y los argumentos pueden diferir entre las notificaciones. Se muestran los valores de la notificación más reciente del grupo. Si se quita esa notificación, los valores vuelven a la siguiente notificación más reciente.

Controlar la activación desde un encabezado

Los encabezados se pueden clicar. La propiedad Arguments del encabezado especifica qué contexto se debe pasar a la aplicación cuando el usuario hace clic en el encabezado, similar a los argumentos de inicio en la propia notificación.

La activación desde un encabezado se controla a través del evento NotificationInvoked , igual que cualquier otra activación de notificación. Para obtener más información sobre cómo configurar la activación, consulte Inicio rápido de notificaciones de aplicaciones.

AppNotificationManager.Default.NotificationInvoked += (sender, args) =>
{
    // For the header defined above, args.Argument contains:
    // "action=openConversation&id=6289"
    string arguments = args.Argument;
};

Más detalles

  • Los encabezados separan visualmente y agrupan las notificaciones, pero no cambian el número máximo de notificaciones que una aplicación puede tener (20) o el comportamiento primero en salir de la lista de notificaciones.
  • El identificador puede ser cualquier cadena. No hay restricciones de longitud ni caracteres en las propiedades del encabezado. La única restricción es que todo el contenido de notificación XML no puede superar los 5 KB.
  • La creación de encabezados no cambia el número de notificaciones que se muestran en el Centro de notificaciones antes de que aparezca el botón "Ver más" (3 de forma predeterminada, configurable por el usuario en la configuración de notificación del sistema).
  • Al hacer clic en un encabezado no se borran las notificaciones que pertenecen a ese encabezado. La aplicación debe usar las API de notificación para borrar las notificaciones pertinentes.

Consulte también