建立以進度為主軸的通知

圖 1. 通知欄頂端顯示進度通知。

Android 16 推出新的通知範本，協助使用者順暢追蹤使用者啟動的起點到終點歷程。這類通知在系統介面上的能見度較高，且在通知導覽匣中排名最高。

使用 Notification.ProgressStyle 設定進度通知的樣式。主要用途包括共乘、外送和導航。在該類別中，您可以使用 Points 和 Segments 表示使用者歷程中的狀態和里程碑。

相關課程

下列類別包含用於建構 ProgressStyle 通知的不同 API：

• Notification.ProgressStyle
• Notification.ProgressStyle.Point
• Notification.ProgressStyle.Segment

結構和自訂

下圖顯示 ProgressStyle 通知的不同組成部分：

圖 2.

A. 標頭 - 次要文字	Notification.Builder#setSubText()
B. 標頭 - 時間	Notification.Builder#setWhen()
C. 內容標題	Notification.Builder#setContentTitle()
D. 內容文字	Notification.Builder#setContentText()
E. 進度列	Notification.ProgressStyle
F. 動作按鈕	Notification.Builder#addAction()

圖 3. 應用程式可以為追蹤器圖示設定車輛圖片，並使用區隔和點來表示共乘體驗和里程碑。

最佳做法

使用正確的 API 並遵循最佳做法，為進度更新提供最佳使用者體驗。

• 設定正確的欄位，讓通知在通知欄中更醒目。
• 使用合適的視覺元素引導使用者。舉例來說，共乘應用程式應設定車輛圖片，並使用 Notification#setLargeIcon 在通知中顯示最準確的車輛顏色。
• 使用簡潔明瞭的語言定義使用者歷程的進度。抵達時間、司機姓名和行程狀態是通知應傳達的重要文字。
• 在通知中提供實用且相關的操作，簡化使用者歷程。舉例來說，在餐點外送訂單剛成立時，提供「小費」和「新增餐點」選項，就是外送前實用的動作。
• 使用區段和點表示狀態。舉例來說，區隔可以為共乘行程中的交通狀態和時間長度著色。點代表里程碑的狀態，例如備餐、外送和乘客上車。
• 更新進度體驗，準確反映行程的實際進度。舉例來說，路況變化會反映在路段顏色和文字更新上。

下列程式碼片段說明如何將 ProgressStyle 通知用於共乘情境：

var ps =
    Notification.ProgressStyle()
        .setStyledByProgress(false)
        .setProgress(456)
        .setProgressTrackerIcon(Icon.createWithResource(appContext, R.drawable.ic_car_red))
        .setProgressSegments(
            listOf(
                Notification.ProgressStyle.Segment(41).setColor(Color.BLACK),
                Notification.ProgressStyle.Segment(552).setColor(Color.YELLOW),
                Notification.ProgressStyle.Segment(253).setColor(Color.WHITE),
                Notification.ProgressStyle.Segment(94).setColor(Color.BLUE)
            )
        )
        .setProgressPoints(
            listOf(
                Notification.ProgressStyle.Point(60).setColor(Color.RED),
                Notification.ProgressStyle.Point(560).setColor(Color.GREEN)
            )
        )

請參閱範例應用程式，試用這些 API。