應用程式通知上的自訂時間戳記

  • 發行項

根據預設，應用程式通知上的時間戳記會在通知中心內顯示，並且設定為通知傳送的時間。 您可以選擇性地使用自己的自訂日期和時間覆寫時間戳記，讓時間戳記代表訊息/資訊/內容實際傳送的時間，而非通知傳送的時間。 這樣也可確保您的通知會以正確的順序出現在通知中心內，也就是依時間排序。 我們建議大部分的應用程式指定自訂時間戳記。

此功能已在 Windows 組建 15063 和更新版本中提供。

App notification with custom timestamp

注意

「快顯通知」一詞正取代為「應用程式通知」。 這些詞彙都是指 Windows 的相同功能，但隨著時間推移，我們將逐步淘汰文件中的「快顯通知」使用。

若要使用自訂時間戳記，只需在您的應用程式通知 XML 承載的 toast 元素上指派 displayTimestamp 屬性即可。 從 Windows App SDK 1.2 開始，您可以使用 Microsoft.Windows.AppNotifications.Builder 將自訂時間戳記新增至應用程式通知。 若是 UWP 應用程式，您可以使用 UWP 社群工具組通知 NuGet 程式庫 1.4.0 版或更新版本。 您也可以使用原始 xml 指定時間戳記。

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));

如果您使用 XML，則日期必須依照 ISO 8601 格式化。

注意

秒數只能使用最多 3 個小數位數 (雖然實際上沒有任何值可提供更精細的內容)。 如果您提供更多小數位數，承載將會無效，而且您會收到「新通知」通知。

使用方式指導

一般而言，我們建議大部分的應用程式指定自訂時間戳記。 這樣可確保無論是網路延遲、飛航模式，或定期背景工作的固定時間間隔為何，通知的時間戳記都會正確代表訊息/資訊/內容產生的時間。

例如，新聞應用程式可能會每隔 15 分鐘執行一次背景工作，以查看是否有新文章並顯示通知。 在自訂時間戳記之前，時間戳記會對應至應用程式通知產生的時間 (因此一律為 15 分鐘間隔)。 不過，現在應用程式可以將時間戳記設定為文章實際發佈的時間。 同樣地，如果電子郵件應用程式和社交網路應用程式的通知使用類似的定期輪詢模式，則此功能會很實用。

此外，提供自訂時間戳記可確保即使在使用者網際網路連線中斷的情況下，時間戳記仍正確無誤。 例如，當使用者將電腦開機且您的背景工作執行時，您就可以確保通知上的時間戳記代表訊息傳送的時間，而非使用者將電腦開機的時間。

預設時間戳記

如果您為提供自訂時間戳記，我們會使用您的通知傳送的時間。

如果您透過 WNS 傳送推播通知，我們會使用 WNS 伺服器收到通知的時間 (因此，將通知傳遞至裝置的任何延遲都不會影響時間戳記)。

如果您傳送本機通知，我們會使用通知平台收到通知的時間 (應是立即)。