共用方式為

應用程式通知上的自定義時間戳

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

此功能適用於 Windows 版本 15063 和更新版本。

應用程式通知 使用自訂時間戳

Note

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

若要使用自定義時間戳，只需在應用程式通知 XML 承載的 快顯通知 元素上指派 displayTimestamp 属性即可。 從 Windows App SDK 1.2 開始，您可以使用 .Windows.AppNotifications.Builder Microsoft，將自定義時間戳新增至應用程式通知。 針對 UWP 應用程式，您可以使用版本 1.4.0 或更高版本的 UWP Community Toolkit Notifications NuGet 程式庫。 YOu 也會使用原始 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。

Note

您最多只能使用 3 位小數秒數（雖然實際上這樣的細節並沒有什麼價值）。 如果您提供更多內容，承載將會無效，而且您會收到「新增通知」通知。

使用指引

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

例如，新聞應用程式可能會每隔 15 分鐘執行一次背景工作，以檢查新文章並顯示通知。 在自定義時間戳之前，時間戳會對應至產生應用程式通知的時間（因此一律在15分鐘間隔內）。 不過，現在應用程式可以將時間戳設定為發行項實際發佈的時間。 同樣地，如果電子郵件應用程式和社交網路應用程式的通知採用類似的定期提取模式，則可以從這個功能中受益。

此外，提供自定義時間戳可確保即使使用者與因特網中斷連線，時間戳也是正確的。 例如，當使用者開啟計算機並執行背景工作時，您終於可以確定通知上的時間戳代表訊息傳送的時間，而不是使用者開啟其計算機的時間。

預設時間戳記

如果您沒有提供自定義時間戳，我們會使用您的通知傳送時間。

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

如果您傳送本機通知，我們會使用通知平臺收到通知的時間（應該立即）。

  • Last updated on