Cabeçalhos de notificação da aplicação

Pode agrupar visualmente um conjunto de notificações relacionadas no Centro de Notificações, adicionando um cabeçalho às suas notificações.

No exemplo mostrado abaixo, esta conversa de grupo está unificada sob um único cabeçalho, "Camping!!". Cada mensagem individual na conversa é uma notificação de aplicação separada que partilha o mesmo cabeçalho.

Também pode agrupar visualmente as notificações por categoria, como lembretes de voo, rastreio de encomendas e mais.

Para mais informações sobre as notificações da aplicação, consulte Visão Geral das notificações da aplicação.

Adicionar um cabeçalho a uma notificação

Observação

O AppNotificationBuilder não inclui atualmente um SetHeader método, por isso use o payload XML diretamente 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 sob o mesmo cabeçalho, use o mesmo ID de cabeçalho em cada notificação. O Id é a única propriedade usada para determinar o agrupamento — o Título e os Argumentos podem diferir entre notificações. Os valores da notificação mais recente no grupo são exibidos. Se essa notificação for removida, os valores voltam para a notificação mais recente.

Ativação da manipulação a partir de um cabeçalho

Os cabeçalhos são clicáveis. A propriedade Argumentos no cabeçalho especifica o contexto a passar à sua app quando o utilizador clica no cabeçalho, semelhante aos argumentos de lançamento na própria notificação.

A ativação a partir de um cabeçalho é gerida através do evento NotificationInvoked , tal como qualquer outra ativação de notificação. Para mais informações sobre como configurar a ativação, consulte notificações de início rápido da aplicação.

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

Detalhes adicionais

• Os cabeçalhos separam visualmente e agrupam as notificações, mas não alteram o número máximo de notificações que uma aplicação pode ter (20) nem o comportamento do primeiro a entrar, primeiro a sair, da lista de notificações.
• O Id pode ser qualquer fio. Não existem restrições de comprimento ou caracteres nas propriedades do cabeçalho. A única restrição é que todo o conteúdo das notificações XML não pode exceder 5 KB.
• Criar cabeçalhos não altera o número de notificações mostradas no Centro de Notificações antes de aparecer o botão "Ver mais" (3 por defeito, configuráveis pelo utilizador nas definições de notificações do sistema).
• Clicar num cabeçalho não apaga as notificações que pertencem a esse cabeçalho. A sua aplicação deve usar as APIs de notificações para apagar as notificações relevantes.

Consulte também

• Visão geral das notificações da aplicação