建立指標樣式通知

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

使用 MetricStyle 的計時器範例
圖 1:時鐘應用程式的 MetricStyle 通知範本和最新即時資訊

功能

指標樣式通知具有下列功能:

  • 支援使用 setContentTitle 方法。
  • 不顯示內容文字。
  • 最多支援 3 個動作按鈕。
  • 最多可評估 3 項指標。
    • 每個 Notification.Metric 都需要標籤、值和選用單位。
    • 展開版面配置的外觀會因採用的指標數量而異。
各種狀態下的 MetricStyle 範本
圖 2:各種狀態下的 MetricStyle 範本範例。從左到右:螢幕長亮模式 (AOD)、宣傳為最新即時資訊、預設/展開,以及預設/收合。

行為

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

  • 展開狀態下,指標單位會附加至標籤。
  • 收合狀態的第二行會顯示串連成單一行的指標內容。第二和第三項指標只有在串連後能完整顯示時,才會出現。
  • 收合狀態下會省略單位。
  • 無論內容為何,每項指標都會獲得相同的水平空間。

最新即時資訊

將指標樣式通知升級為最新即時資訊時,請注意下列事項:

  • 由於系統會改用指標值,因此您不需要提供 Notification.Builder#setContentTitle。如未提供標題,系統會顯示應用程式名稱。
  • 如果提供 Notification.Builder#setSubtext,則會顯示在標頭行中,而不是像其他升級樣式一樣移至新行。
  • 動作按鈕也採用相同的藥丸形視覺效果。

程式碼重點

另請參閱