Marcas de tempo personalizadas em notificações do aplicativo

Por padrão, o carimbo de data/hora nas notificações do aplicativo, que é visível na Central de Notificações, é definido como o 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, de modo 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.

Para usar um carimbo de data/hora personalizado, basta atribuir a propriedade displayTimestamp no elemento toast no conteúdo XML da notificação do aplicativo. Começando com o SDK do Aplicativo do 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ê pode também especificar o carimbo de data/hora usando XML em 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));

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

<toast displayTimestamp='2017-04-15T12:45:00-07:00'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Matt sent you a friend request</text>
            <text>Hey, wanna dress up as wizards and ride around on hoverboards?</text>
        </binding>
    </visual>
</toast>

Se você estiver usando XML, a data deverá ser formatada no ISO 8601.

Diretrizes de uso

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 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. 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 o aplicativo pode definir a data e hora no momento 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.

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 ativa o computador e sua tarefa em segundo plano é executada, você pode finalmente garantir que o carimbo de data/hora em suas notificações represente o tempo em que as mensagens foram enviadas, em vez da hora em que o usuário ativou o computador.

Timestamp 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 para o dispositivo não afetará o carimbo de data/hora).

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

Tópicos relacionados

• Enviar uma toast local
• Documentação do conteúdo da notificação do aplicativo