Cabeçalhos de notificação do aplicativo

Você pode agrupar visualmente um conjunto de notificações relacionadas no Centro de Notificação adicionando um cabeçalho às notificações.

No exemplo mostrado abaixo, essa conversa em grupo é unificada em um único cabeçalho, "Camping!!". Cada mensagem individual na conversa é uma notificação de aplicativo separada compartilhando o mesmo cabeçalho.

Você também pode agrupar visualmente suas notificações por categoria, como lembretes de voo, acompanhamento de pacotes e muito mais.

Para obter mais informações sobre notificações do aplicativo, consulte a visão geral das notificações do aplicativo.

Adicionar um cabeçalho a uma notificação

Observação

AppNotificationBuilder não possui no momento um SetHeader método, então use diretamente a carga XML com o construtor 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 várias notificações no mesmo cabeçalho, use a mesma ID de cabeçalho em cada notificação. A ID é a única propriedade usada para determinar o agrupamento. O título e os argumentos podem diferir entre as notificações. Os valores da notificação mais recente no grupo são exibidos. Se essa notificação for removida, os valores voltarão para a próxima notificação mais recente.

Lidar com a ativação a partir de um cabeçalho

Cabeçalhos são clicáveis. A propriedade Arguments no cabeçalho especifica qual contexto passar para seu aplicativo quando o usuário clica no cabeçalho, semelhante aos argumentos de inicialização na própria notificação.

A ativação a partir de um cabeçalho é manipulada por meio do evento NotificationInvoked, da mesma forma que qualquer outra ativação de notificação. Para obter mais informações sobre como configurar a ativação, consulte o início rápido das notificações do aplicativo.

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

Detalhes adicionais

• Cabeçalhos separam visualmente e agrupam notificações, mas não alteram o número máximo de notificações que um aplicativo pode ter (20) ou o comportamento de primeiro a entrar, primeiro a sair da lista de notificações.
• A ID pode ser qualquer cadeia de caracteres. Não há restrições de comprimento ou caractere nas propriedades do cabeçalho. A única restrição é que todo o conteúdo de notificação XML não pode exceder 5 KB.
• A criação de cabeçalhos não altera o número de notificações mostradas na Central de Notificações antes que o botão "Ver mais" apareça (3 por padrão, configurável pelo usuário nas configurações de notificação do sistema).
• Clicar em um cabeçalho não limpa as notificações que pertencem a esse cabeçalho. Seu aplicativo deve usar as APIs de notificação para limpar as notificações relevantes.

Consulte também

• Visão geral das notificações do aplicativo