Marcas de tempo personalizadas em notificações do aplicativo

Por padrão, o carimbo de data/hora nas notificações do aplicativo na Central de Notificações é definido no momento em que a notificação foi enviada. Opcionalmente, você pode substituir o carimbo de data/hora com sua própria data e hora personalizadas para que o carimbo de data/hora represente a hora em que a mensagem ou o conteúdo foi realmente criado, 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.

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

Definir um carimbo de data/hora personalizado

Use AppNotificationBuilder.SetTimeStamp para substituir o timestamp padrão na notificação.

using Microsoft.Windows.AppNotifications.Builder;

var notification = 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))
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Diretrizes de uso

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 ou o conteúdo foi gerado, independentemente dos atrasos de rede, do modo avião ou do 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 novos artigos e exibe notificações. Sem um carimbo de data/hora personalizado, o carimbo de data/hora corresponde a quando a notificação foi gerada (sempre em intervalos de 15 minutos). Com um carimbo de data/hora personalizado, o aplicativo pode configurá-lo para a hora em que o artigo foi realmente publicado. Da mesma forma, aplicativos de email e aplicativos de rede social podem se beneficiar desse recurso se um padrão semelhante de pull periódico for usado para suas notificações.

Fornecer um carimbo de data/hora personalizado também 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 ativa o computador e sua tarefa em segundo plano é executada, você pode garantir que o carimbo de data/hora represente o tempo em que as mensagens foram enviadas, em vez do tempo em que o usuário ativou o computador.

Timestamp padrão

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

• Para notificações por push enviadas por meio do WNS, o carimbo de data/hora é definido como o momento em que a notificação foi recebida pelo servidor WNS.
• Para notificações locais, a data e hora é definida como o momento em que a notificação foi recebida pela plataforma de notificações.

Consulte também

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