Compartilhar via

Notificação de ativação de atualização pendente

Você pode usar PendingUpdate para criar interações de várias etapas em suas notificações toast. Por exemplo, conforme visto abaixo, você pode criar uma série de notificações em que as notificações subsequentes dependem das respostas das notificações anteriores.

Toast com atualização pendente

Important

requer a Atualização de Fall Creators para Área de Trabalho e a versão 2.0.0 da biblioteca de notificações: você deve estar executando a construção da área de trabalho 16299 ou posterior para ver o trabalho de atualização pendente. Você deve usar a versão 2.0.0 ou posterior da biblioteca NuGet de Notificações do Kit de Ferramentas da Comunidade UWP para atribuir PendingUpdate aos seus botões. PendingUpdate só tem suporte na Área de Trabalho e será ignorado em outros dispositivos.

Prerequisites

Este artigo pressupõe um conhecimento funcional de...

Overview

Para implementar uma notificação que usa a atualização pendente como seu comportamento após a ativação...

  1. Nos seus botões de ativação em segundo plano, especifique um AfterActivationBehavior de PendingUpdate

  2. Atribuir um de Marca de (e, opcionalmente, de Grupo) ao enviar seu sistema

  3. Quando o usuário clicar no seu botão, sua tarefa em segundo plano será ativada, e a notificação será mantida na tela em um estado de atualização pendente.

  4. Em sua tarefa em segundo plano, envie um novo toast com seu novo conteúdo usando o mesmo Tag e Grupo

Assign PendingUpdate

Nos botões de ativação em segundo plano, defina o AfterActivationBehavior como PendingUpdate. Observe que isso só funciona para botões que têm um ActivationType de Background.

new ToastContentBuilder()

    .AddText("Would you like to order lunch today?")

    .AddButton(new ToastButton("Yes", "action=orderLunch")
    {
        ActivationType = ToastActivationType.Background,

        ActivationOptions = new ToastActivationOptions()
        {
            AfterActivationBehavior = ToastAfterActivationBehavior.PendingUpdate
        }
    });

Usar uma tag na notificação

Para posteriormente substituir a notificação, precisamos atribuir a Tag (e, opcionalmente, o Grupo ) na notificação.

// Create the notification
var notif = new ToastNotification(content.GetXml())
{
    Tag = "lunch"
};

// And show it
ToastNotificationManager.CreateToastNotifier().Show(notif);

Substituir a torrada por novo conteúdo

Em resposta ao clique do usuário no seu botão, sua tarefa em segundo plano é disparada e você precisa substituir a notificação com um novo conteúdo. Você substitui a notificação simplesmente enviando uma nova notificação com a mesma Tag , e Grupo ,.

Recomendamos fortemente definir o áudio como silencioso em substituições em resposta a um clique de botão, já que o usuário já está interagindo com sua notificação.

// Generate new content
ToastContent content = new ToastContent()
{
    ...

    // We disable audio on all subsequent toasts since they appear right after the user
    // clicked something, so the user's attention is already captured
    Audio = new ToastAudio() { Silent = true }
};

// Create the new notification
var notif = new ToastNotification(content.GetXml())
{
    Tag = "lunch"
};

// And replace the old one with this one
ToastNotificationManager.CreateToastNotifier().Show(notif);
  • Last updated on