建立自訂通知版面配置

為了讓通知在各種 Android 版本上呈現最佳視覺效果， 使用標準通知 範本 通知。如要在通知中提供更多內容， 建議使用可展開的通知 範本

不過，如果系統範本不符合您的需求，您可以使用自己的 版面配置

注意： 使用自訂通知版面配置時，請特別留意 自訂版面配置適用於不同的裝置方向和解析度。 雖然這項建議適用於所有 UI 版面配置，但請特別注意 通知，因為通知導覽匣中的空間受到限制。 自訂通知版面配置可用的高度，取決於 Android 版本。在某些版本中，收合的檢視版面配置可以減少 48 dp，抬頭檢視畫面版面配置的最小容量應為 88 dp，以及 展開的檢視畫面版面配置的大小上限為 252 dp。

為內容區域建立自訂版面配置

如果需要自訂版面配置 NotificationCompat.DecoratedCustomViewStyle敬上 通知。這個 API 可讓您為內容提供自訂版面配置 區域通常由標題和文字內容佔用，但您仍是使用系統 通知圖示、時間戳記、子文字和動作按鈕的裝飾。

這個 API 的運作方式類似於可展開式通知範本，也就是以基本通知為基礎建構而成 如下所示：

1. 建立基本通知 同時 NotificationCompat.Builder。
2. 致電 setStyle()、 並向該函式傳送 NotificationCompat.DecoratedCustomViewStyle。
3. 將自訂版面配置加載為 RemoteViews。
4. 致電 setCustomContentView()敬上 設定收合通知的版面配置。
5. 或者也可以呼叫 setCustomBigContentView()敬上 為展開的通知設定不同的版面配置。

，瞭解如何調查及移除這項存取權。

注意： 如要為媒體播放控制項建立自訂通知， 遵循相同建議，但請使用 請改為使用 NotificationCompat.DecoratedMediaCustomViewStyle 類別。

準備版面配置

您需要有 small 和 large 版面配置。在此範例中，small 版面配置 看起來會像這樣：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical">

    <TextView
        android:id="@+id/notification_title"
        style="@style/TextAppearance.Compat.Notification.Title"
        android:layout_width="wrap_content"
        android:layout_height="0dp"
        android:layout_weight="1"
        android:text="Small notification, showing only a title" />
</LinearLayout>

large 版面配置可能如下所示：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="300dp"
    android:orientation="vertical">

    <TextView
        android:id="@+id/notification_title"
        style="@style/TextAppearance.Compat.Notification.Title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="Large notification, showing a title and a body." />

    <TextView
        android:id="@+id/notification_body"
        style="@style/TextAppearance.Compat.Notification.Line2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="This is the body. The height is manually forced to 300dp." />
</LinearLayout>

建構並顯示通知

版面配置準備就緒後，您可以使用這些版面配置，如以下範例所示：

Kotlin

val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

// Get the layouts to use in the custom notification.
val notificationLayout = RemoteViews(packageName, R.layout.notification_small)
val notificationLayoutExpanded = RemoteViews(packageName, R.layout.notification_large)

// Apply the layouts to the notification.
val customNotification = NotificationCompat.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setStyle(NotificationCompat.DecoratedCustomViewStyle())
        .setCustomContentView(notificationLayout)
        .setCustomBigContentView(notificationLayoutExpanded)
        .build()

notificationManager.notify(666, customNotification)

Java

NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);

// Get the layouts to use in the custom notification
RemoteViews notificationLayout = new RemoteViews(getPackageName(), R.layout.notification_small);
RemoteViews notificationLayoutExpanded = new RemoteViews(getPackageName(), R.layout.notification_large);

// Apply the layouts to the notification.
Notification customNotification = new NotificationCompat.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setStyle(new NotificationCompat.DecoratedCustomViewStyle())
        .setCustomContentView(notificationLayout)
        .setCustomBigContentView(notificationLayoutExpanded)
        .build();

notificationManager.notify(666, customNotification);

請注意，通知的背景顏色可能因裝置而異 和版本可套用支援資料庫樣式，例如 TextAppearance_Compat_Notification 用於文字和 TextAppearance_Compat_Notification_Title，做為自訂版面配置中的標題。 如以下範例所示這些樣式會配合顏色變化 但你的文字最後不會有黑色或白色

<TextView
    android:layout_width="wrap_content"
    android:layout_height="match_parent"
    android:layout_weight="1"
    android:text="@string/notification_title"
    android:id="@+id/notification_title"
    style="@style/TextAppearance.Compat.Notification.Title" />

請避免在 RemoteViews 物件上設定背景圖片，因為文字 可能會變得無法讀取

如果使用者在使用應用程式時觸發通知，結果會是 就像圖 1 一樣

圖 1：畫面上隨即會顯示小型的通知版面配置 在使用其他應用程式時

輕觸展開箭頭即可展開通知，如圖 2 所示：

圖 2 顯示大型通知版面配置 在使用其他應用程式時

通知逾時屆滿後，通知只會顯示在 系統資訊列，如圖 3 所示：

圖 3. 小型通知版面配置的方式 。

輕觸展開箭頭即可展開通知，如圖 4 所示：

圖 4. 大型通知版面配置的 系統資訊列

建立完全自訂的通知版面配置

注意： 指定 Android 的應用程式 12 (API 級別 31) 或之後無法建立完全自訂的通知。反之，系統會套用 標準範本的行為與 Notification.DecoratedCustomViewStyle。

如果不想讓通知加上標準通知裝飾 圖示和標頭，請依上述步驟操作，但「不要」呼叫 setStyle()。

注意： 我們不建議使用未修飾通知，因為這不包括 比對其他通知，並可能會導致重大的版面配置相容性問題 在使用者針對通知區域套用不同樣式的裝置上。