本頁面由 Cloud Translation API 翻譯而成。

建立自訂通知版面配置

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

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

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

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

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

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

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

準備版面配置

您需要有 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 所示：

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

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

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