Cabeçalhos do sistema

Você pode agrupar visualmente um conjunto de notificações relacionadas dentro da Central de Ações usando um cabeçalho de notificação do sistema em suas notificações.

Como visto abaixo, esta conversa em grupo é unificada em um único cabeçalho, "Camping!!". Cada mensagem individual na conversa é uma notificação do sistema separada que compartilha o mesmo cabeçalho do sistema.

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

Adicionar um cabeçalho a uma notificação do sistema

Veja como adicionar um cabeçalho a uma notificação do sistema.

new ToastContentBuilder()
    .AddHeader("6289", "Camping!!", "action=openConversation&id=6289")
    .AddText("Anyone have a sleeping bag I can borrow?");

<toast>

    <header
        id="6289"
        title="Camping!!"
        arguments="action=openConversation&amp;id=6289"/>

    <visual>
        ...
    </visual>

</toast>

Em resumo...

1. Adicionar o cabeçalho ao seu ToastContent
2. Atribuir as propriedades Id, Title e Arguments necessárias
3. Envie sua notificação (saiba mais)
4. Em outra notificação, use a mesma ID de cabeçalho para unificá-los sob o cabeçalho. O Id é a única propriedade usada para determinar se as notificações devem ser agrupadas, o que significa que o Título e os Argumentos podem ser diferentes. O Título e os Argumentos da notificação mais recente em um grupo são usados. Se essa notificação for removida, o Título e os Argumentos retornarão para a próxima notificação mais recente.

Manipular a ativação de um cabeçalho

Os cabeçalhos são clicáveis pelos usuários, para que o usuário possa clicar no cabeçalho para saber mais sobre seu aplicativo.

Portanto, os aplicativos podem fornecer argumentos no cabeçalho, semelhantes aos argumentos de inicialização na própria notificação do sistema.

A ativação é tratada de forma idêntica à ativação normal da notificação do sistema, o que significa que você pode recuperar esses argumentos no método OnActivated da App.xaml.cs mesma forma que faz quando o usuário clica no corpo da notificação do sistema ou em um botão da notificação do sistema.

protected override void OnActivated(IActivatedEventArgs e)
{
    // Handle toast activation
    if (e is ToastNotificationActivatedEventArgs)
    {
        // Arguments specified from the header
        string arguments = (e as ToastNotificationActivatedEventArgs).Argument;
    }
}

Informações adicionais

O cabeçalho separa e agrupa visualmente as notificações. Isso não altera nenhuma outra logística sobre o número máximo de notificações que um aplicativo pode ter (20) e o comportamento primeiro a entrar, primeiro a sair da lista de notificações.

A ordem das notificações nos cabeçalhos é a seguinte... Para um determinado aplicativo, a notificação mais recente do aplicativo (e todo o grupo de cabeçalhos, se fizer parte de um cabeçalho) aparecerá primeiro.

O Id pode ser qualquer string que você escolher. Não há restrições de comprimento ou caractere em nenhuma das propriedades em ToastHeader. A única restrição é que todo o conteúdo da notificação do sistema XML não pode ser maior que 5 KB.

A criação de cabeçalhos não altera o número de notificações mostradas na Central de Ações antes que o botão "Ver mais" apareça (esse número é 3 por padrão e pode ser configurado pelo usuário para cada aplicativo nas Configurações do sistema para notificações).

Clicar no cabeçalho, assim como clicar no título do aplicativo, não limpa nenhuma notificação pertencente a esse cabeçalho (seu aplicativo deve usar as APIs de notificação do sistema para limpar as notificações relevantes).

Tópicos relacionados

• Enviar uma notificação do sistema local e manipular a ativação
• Documentação de conteúdo da notificação do sistema