共用方式為

快顯通知 (快顯通知 XML 架構)

  • 發行項

基底快顯通知專案，其中包含至少一個 視覺 元素。

元素階層

<吐 司>

Syntax

<toast launch?   = string
      duration? = "long" | "short" 
      displayTimeStamp? = string
      scenario? = "reminder" | "alarm" | "incomingCall" | "urgent" 
      useButtonStyle? = boolean>

  <!-- Child elements -->
  visual,
  audio?,
  commands?
  actions?
  header?
</toast>

答案

? 選擇性 (零或一個)

屬性和項目

屬性

屬性 描述 資料類型 必要 預設值
duration

快顯通知應該顯示的時間量。

此屬性可以有下列其中一個值：

  • long
  • short
 No 無
啟動

快顯通知啟動應用程式時，傳遞給應用程式的字串。 此字串的格式和內容是由應用程式定義以供應用程式自己使用。 當使用者點選或按一下快顯通知來啟動其相關聯應用程式時，啟動字串會提供相關內容給應用程式，以允許應用程式向使用者顯示與快顯通知內容有關的檢視，而非以其預設方式啟動。

 字串 No 無
displayTimestamp

Creators Update 中引進：使用自訂時間戳記覆寫預設時間戳記，代表您實際傳遞通知內容的時間，而不是 Windows 平臺收到通知的時間。 此值必須是使用 ISO 8601 標準格式化的字串。

 字串 No 無
場景

您的快顯通知用於的案例，例如警示或提醒。

  • 「reminder」 - 提醒通知。 這會以預先展開的方式顯示，並停留在使用者的螢幕上，直到關閉為止。 請注意，除非背景中啟動快顯通知按鈕動作，否則將會以無訊息方式忽略此動作。
  • 「警示」- 警示通知。 這會以預先展開的方式顯示，並停留在使用者的螢幕上，直到關閉為止。 音效預設會重複播放，並使用鬧鐘音效。
  • 「incomingCall」 - 來電通知。 這會使用特殊通話格式以預先展開的方式顯示，並停留在使用者的螢幕上，直到關閉為止。 音效預設會重複播放，並使用鈴聲音效。
  • 「緊急」- 重要通知。 這可讓使用者更充分掌控哪些應用程式可以傳送高優先順序快顯通知，這些通知可以中斷焦點輔助 (「不要打擾」) 。 這可以在通知設定中修改。

 字串 No 無
useButtonStyle

指定是否應該使用樣式按鈕。 按鈕的樣式是由 動作 專案的 **hint-buttonStyle** 屬性所決定。

 boolean No false

 

子元素

子元素 描述
音訊

指定顯示快顯通知時要播放的音效。 這個專案也可讓您將任何快顯通知音訊靜音。
commands

指定快顯通知正用來指出來電或警示，並具有與每個案例相關聯的適當命令。
視覺

包含定義快顯通知的單一 綁定 項。
actions

用於宣告最多五個輸入的容器元素，以及快顯通知最多五個按鈕動作。
頭

Creators Update 中引進。 指定自訂標頭，在控制中心內將多個通知群組在一起。

 

父項目

此最外層 (檔) 元素可能不會包含任何其他元素。

另請參閱