Partilhar via

Carimbos de tempo personalizados nas notificações da app

Por padrão, o carimbo de data/hora nas notificações do aplicativo, que é visível na Central de Notificações, é definido para a hora em que a notificação foi enviada. Opcionalmente, você pode substituir o carimbo de data/hora por sua própria data e hora personalizadas, para que o carimbo de data/hora represente a hora em que a mensagem/informação/conteúdo foi realmente criada, em vez da hora em que a notificação foi enviada. Isso também garante que suas notificações apareçam na ordem correta na Central de Notificações, que é classificada por tempo. Recomendamos que a maioria dos aplicativos especifique um carimbo de data/hora personalizado.

Esse recurso está disponível no Windows Build 15063 e posterior.

Notificação da aplicação com carimbo de data/hora personalizado

Note

O termo "notificação de brinde" será substituído por "notificação do aplicativo". Ambos os termos se referem ao mesmo recurso do Windows, mas com o tempo eliminaremos gradualmente o uso de "toast notification" na documentação.

Para usar um carimbo de data/hora personalizado, basta atribuir a propriedade displayTimestamp no elemento do sistema da carga XML de notificação do aplicativo. A partir do SDK do Aplicativo Windows 1.2, você pode adicionar um carimbo de data/hora personalizado a uma notificação de aplicativo com o Microsoft.Windows.AppNotifications.Builder. Para aplicativos UWP, você pode usar a versão 1.4.0 ou posterior da biblioteca NuGet de Notificações do Kit de Ferramentas da Comunidade UWP . Você também pode especificar o carimbo de data/hora usando XML bruto.

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));

Se você estiver usando XML, a data deve ser formatada em ISO 8601.

Note

Você só pode usar no máximo 3 casas decimais nos segundos (embora, de forma realista, não haja valor em fornecer algo tão minucioso). Se fornecer mais, a carga será inválida e irá receber a notificação de "Nova notificação".

Orientação de utilização

Em geral, recomendamos que a maioria dos aplicativos especifique um carimbo de data/hora personalizado. Isso garante que o carimbo de data/hora da notificação represente com precisão quando a mensagem/informação/conteúdo foi gerada, independentemente de atrasos na rede, no modo avião ou no intervalo fixo de tarefas periódicas em segundo plano.

Por exemplo, um aplicativo de notícias pode executar uma tarefa em segundo plano a cada 15 minutos que verifica se há novos artigos e exibe notificações. Antes dos carimbos de data/hora personalizados, o carimbo de data/hora correspondia a quando a notificação do aplicativo era gerada (portanto, sempre em intervalos de 15 minutos). No entanto, agora a aplicação pode definir a data e hora para o momento em que o artigo foi realmente publicado. Da mesma forma, aplicativos de e-mail e aplicativos de redes sociais podem se beneficiar desse recurso se um padrão semelhante de extração periódica for usado para suas notificações.

Além disso, fornecer um carimbo de data/hora personalizado garante que o carimbo de data/hora esteja correto, mesmo que o usuário tenha sido desconectado da Internet. Por exemplo, quando o usuário liga o computador e a tarefa em segundo plano é executada, você pode finalmente garantir que o carimbo de data/hora nas notificações represente a hora em que as mensagens foram enviadas, em vez da hora em que o usuário ligou o computador.

Marca temporal padrão

Se você não fornecer um carimbo de data/hora personalizado, usaremos a hora em que sua notificação foi enviada.

Se você enviou uma notificação por push por meio do WNS, usamos a hora em que a notificação foi recebida pelo servidor WNS (portanto, qualquer latência na entrega da notificação ao dispositivo não afetará o carimbo de data/hora).

Se você enviou uma notificação local, usamos o tempo em que a plataforma de notificação recebeu a notificação (que deve ser imediatamente).

  • Last updated on