建立指標樣式通知

Android 17 推出 MetricStyle 通知範本，支援健康與健身應用程式、計時器和旅遊應用程式用途。

使用 MetricStyle 的計時器範例
圖 1：時鐘應用程式的 MetricStyle 通知範本和即時更新

功能

指標樣式通知具備下列功能：

  • 支援使用 setContentTitle 方法。
  • 不會顯示情境文字。
  • 最多支援 3 個動作按鈕。
  • 最多可評估 3 項指標。
    • 每個 Notification.Metric 都需要標籤、值和選用單位。
    • 展開版面配置的外觀會因擷取的指標數量而異。
處於各種狀態的 MetricStyle 範本
圖 2：處於各種狀態的 MetricStyle 範本示例。從左到右依序為螢幕長亮模式、宣傳為「即時更新」的模式、預設/展開模式，以及預設/摺疊模式。

行為

指標樣式通知會根據狀態變更行為：

  • 展開狀態下，標籤會附加公制單位。
  • 在摺疊狀態下，第二行會顯示串連成單行的指標內容。只有在串連後完全符合條件時，才會顯示第二和第三個指標。
  • 在收合狀態下，系統會省略單位。
  • 無論內容為何，每個指標都會獲得相同的水平空間。

即時報導

將指標樣式通知升級為即時更新時，請注意下列事項：

  • 不需要提供 Notification.Builder#setContentTitle，因為系統會改用指標值。如果未提供標題，系統會顯示應用程式名稱。
  • 如果提供 Notification.Builder#setSubtext，系統會將其顯示在標題行中，而不是像其他宣傳樣式一樣移至新行。
  • 動作按鈕採用相同的藥丸狀視覺處理方式。

程式碼重點

另請參閱