Android通知Notification全面剖析

通知

通知是您能夠在應用的常規 UI 外部向用戶顯示的消息。當您告知系統發出通知時，它將先以圖標的形式顯示在通知區域中。用戶能夠打開抽屜式通知欄查看通知的詳細信息。 通知區域和抽屜式通知欄均是由系統控制的區域，用戶能夠隨時查看。

圖 1. 通知區域中的通知。

圖 2. 抽屜式通知欄中的通知。

注：除非特別註明，不然本指南均引用版本 4 支持庫中的 NotificationCompat.Builder 類。Android 3.0（API 級別 11）中已添加類 Notification.Builder。

設計注意事項

做爲 Android 用戶界面的一個重要組成部分，通知具備本身的設計指導方針。Android 5.0（API 級別 21）中引入的 Material Design 變動尤其重要。

建立通知

您能夠在 NotificationCompat.Builder 對象中爲通知指定 UI 信息和操做。要建立通知，請調用 NotificationCompat.Builder.build()，它將返回包含您的具體規範的 Notification 對象。要發出通知，請經過調用 NotificationManager.notify() 將 Notification 對象傳遞給系統。

必需的通知內容

Notification 對象必須包含如下內容：

小圖標，由 setSmallIcon() 設置 標題，由 setContentTitle() 設置 詳細文本，由 setContentText() 設置

可選通知內容和設置

全部其餘通知設置和內容都是可選的。如需瞭解有關它們的更多詳情，請參閱 NotificationCompat.Builder 參考文檔。

通知操做

儘管通知操做都是可選的，可是您至少應向通知添加一個操做。 操做容許用戶直接從通知轉到應用中的 Activity，他們可在其中查看一個或多個事件或執行進一步的操做。

一個通知能夠提供多個操做。您應該始終定義一個當用戶點擊通知時會觸發的操做；一般，此操做會在應用中打開 Activity。 您也能夠向通知添加按鈕來執行其餘操做，例如，暫停鬧鈴或當即答覆短信；此功能自 Android 4.1 起可用。若是使用其餘操做按鈕，則您還必須使這些按鈕的功能在應用的 Activity 中可用

在 Notification 內部，操做自己由 PendingIntent 定義，後者包含在應用中啓動 Activity 的 Intent。要將 PendingIntent 與手勢相關聯，請調用 NotificationCompat.Builder 的適當方法。例如，若是您要在用戶點擊抽屜式通知欄中的通知文本時啓動 Activity，則可經過調用 setContentIntent() 來添加 PendingIntent。

在用戶點擊通知時啓動 Activity 是最多見的操做場景。此外，您還能夠在用戶清除通知時啓動 Activity。在 Android 4.1 及更高版本中，您能夠經過操做按鈕啓動 Activity。

通知優先級

您能夠根據須要設置通知的優先級。優先級充當一個提示，提醒設備 UI 應該如何顯示通知。 要設置通知的優先級，請調用 NotificationCompat.Builder.setPriority() 並傳入一個 NotificationCompat 優先級常量。有五個優先級別，範圍從 PRIORITY_MIN (-2) 到 PRIORITY_MAX (2)；若是未設置，則優先級默認爲 PRIORITY_DEFAULT (0)。

有關設置適當優先級別的信息，請參閱通知設計指南中的「正確設置和管理通知優先級」。

建立簡單通知

如下代碼段說明了一個指定某項 Activity 在用戶點擊通知時打開的簡單通知。 請注意，該代碼將建立 TaskStackBuilder 對象並使用它來爲操做建立 PendingIntent。啓動 Activity 時保留導航部分對此模式作了更詳盡的闡述：

NotificationCompat.Builder mBuilder =
        new NotificationCompat.Builder(this)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!");
// Creates an explicit intent for an Activity in your app
Intent resultIntent = new Intent(this, ResultActivity.class);

// The stack builder object will contain an artificial back stack for the
// started Activity.
// This ensures that navigating backward from the Activity leads out of
// your application to the Home screen.
TaskStackBuilder stackBuilder = TaskStackBuilder.create(this);
// Adds the back stack for the Intent (but not the Intent itself)
stackBuilder.addParentStack(ResultActivity.class);
// Adds the Intent that starts the Activity to the top of the stack
stackBuilder.addNextIntent(resultIntent);
PendingIntent resultPendingIntent =
        stackBuilder.getPendingIntent(
            0,
            PendingIntent.FLAG_UPDATE_CURRENT
        );
mBuilder.setContentIntent(resultPendingIntent);
NotificationManager mNotificationManager =
    (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
// mId allows you to update the notification later on.
mNotificationManager.notify(mId, mBuilder.build());
複製代碼

就這麼簡單。您的用戶現已收到通知。

將擴展布局應用於通知

要使通知出如今展開視圖中，請先建立一個帶有所需普通視圖選項的 NotificationCompat.Builder 對象。接下來，調用以擴展布局對象做爲其參數的 Builder.setStyle()。

請記住，擴展通知在 Android 4.1 以前的平臺上不可用。要了解如何處理針對 Android 4.1 及更早版本平臺的通知，請閱讀處理兼容性部分。

例如，如下代碼段演示瞭如何更改在前面的代碼段中建立的通知，以便使用擴展布局：

NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(this)
    .setSmallIcon(R.drawable.notification_icon)
    .setContentTitle("Event tracker")
    .setContentText("Events received")
NotificationCompat.InboxStyle inboxStyle =
        new NotificationCompat.InboxStyle();
String[] events = new String[6];
// Sets a title for the Inbox in expanded layout
inboxStyle.setBigContentTitle("Event tracker details:");
...
// Moves events into the expanded layout
for (int i=0; i < events.length; i++) {

    inboxStyle.addLine(events[i]);
}
// Moves the expanded layout object into the notification object.
mBuilder.setStyle(inBoxStyle);
...
// Issue the notification here.
複製代碼

處理兼容性

並不是全部通知功能均可用於某特定版本，即使用於設置這些功能的方法位於支持庫類 NotificationCompat.Builder 中也是如此。 例如，依賴於擴展通知的操做按鈕僅會顯示在 Android 4.1 及更高版本的系統中，這是由於擴展通知自己僅在 Android 4.1 及更高版本的系統中可用。

爲了確保最佳兼容性，請使用 NotificationCompat 及其子類（特別是 NotificationCompat.Builder）建立通知。此外，在實現通知時，請遵循如下流程：

爲全部用戶提供通知的所有功能，不管他們使用何種版本的 Android 系統。 爲此，請驗證是否可從應用的 Activity 中得到全部功能。要執行此操做，您可能須要添加新的 Activity。 例如，若要使用 addAction() 提供中止和啓動媒體播放的控件，請先在應用的 Activity 中實現此控件。 確保全部用戶都可經過點擊通知啓動 Activity 來得到該Activity中的功能。 爲此，請爲 Activity 建立 PendingIntent。調用 setContentIntent() 以將 PendingIntent 添加到通知。 如今，將要使用的擴展通知功能添加到通知。請記住，您添加的任何功能還必須在用戶點擊通知時啓動的 Activity 中可用。

管理通知

當您須要爲同一類型的事件屢次發出同一通知時，應避免建立全新的通知， 而是應考慮經過更改以前通知的某些值和/或爲其添加某些值來更新通知。

例如，Gmail 經過增長未讀消息計數並將每封電子郵件的摘要添加到通知，通知用戶收到了新的電子郵件。 這稱爲「堆疊」通知；通知設計指南對此進行了更詳盡的描述。

注：此 Gmail 功能須要「收件箱」擴展布局，該佈局是自 Android 4.1 版本起可用的擴展通知功能的一部分。

下文介紹如何更新和刪除通知。

更新通知

要將通知設置爲可以更新，請經過調用 NotificationManager.notify() 發出帶有通知 ID 的通知。 要在發出以後更新此通知，請更新或建立 NotificationCompat.Builder 對象，從該對象構建 Notification 對象，併發出與以前所用 ID 相同的 Notification。若是以前的通知仍然可見，則系統會根據 Notification 對象的內容更新該通知。相反，若是以前的通知已被清除，系統則會建立一個新通知。

如下代碼段演示了通過更新以反映所發生事件數量的通知。 它將通知堆疊並顯示摘要：

mNotificationManager =
        (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
// Sets an ID for the notification, so it can be updated
int notifyID = 1;
mNotifyBuilder = new NotificationCompat.Builder(this)
    .setContentTitle("New Message")
    .setContentText("You've received new messages.")
    .setSmallIcon(R.drawable.ic_notify_status)
numMessages = 0;
// Start of a loop that processes data and then notifies the user
...
    mNotifyBuilder.setContentText(currentText)
        .setNumber(++numMessages);
    // Because the ID remains unchanged, the existing notification is
    // updated.
    mNotificationManager.notify(
            notifyID,
            mNotifyBuilder.build());
...
複製代碼

刪除通知

除非發生如下狀況之一，不然通知仍然可見：

用戶單獨或經過使用「所有清除」清除了該通知（若是通知能夠清除）。 用戶點擊通知，且您在建立通知時調用了 setAutoCancel()。 您針對特定的通知 ID 調用了 cancel()。此方法還會刪除當前通知。 您調用了 cancelAll() 方法，該方法將刪除以前發出的全部通知。 啓動 Activity 時保留導航 從通知中啓動 Activity 時，您必須保留用戶的預期導航體驗。 點擊「返回」應該使用戶將應用的正常工做流回退到主屏幕，而點擊「最新動態」則應將 Activity 顯示爲單獨的任務。 要保留導航體驗，您應該在全新任務中啓動 Activity。如何設置 PendingIntent 以得到全新任務取決於正在啓動的 Activity 的性質。通常有兩種狀況：

常規 Activity

您要啓動的 Activity 是應用的正常工做流的一部分。在這種狀況下，請設置 PendingIntent 以啓動全新任務併爲 PendingIntent提供返回棧，這將重現應用的正常「返回」行爲。 Gmail 應用中的通知演示了這一點。點擊一封電子郵件消息的通知時，您將看到消息具體內容。 觸摸返回將使您從 Gmail 回退到主屏幕，就好像您是從主屏幕（而不是通知）進入 Gmail 同樣。

不管您觸摸通知時處於哪一個應用，都會發生這種狀況。 例如，若是您在 Gmail 中撰寫消息時點擊了一封電子郵件的通知，則會當即轉到該電子郵件。 觸摸「返回」會依次轉到收件箱和主屏幕，而不是轉到您在撰寫的郵件。

特殊 Activity

僅當從通知中啓動時，用戶纔會看到此 Activity。 從某種意義上說，Activity 是經過提供很難顯示在通知自己中的信息來擴展通知。對於這種狀況，請將 PendingIntent 設置爲在全新任務中啓動。可是，因爲啓動的 Activity 不是應用 Activity 流程的一部分，所以無需建立返回棧。點擊「返回」仍會將用戶帶到主屏幕。 設置常規 Activity PendingIntent 要設置可啓動直接進入 Activity 的 PendingIntent，請執行如下步驟：

在清單文件中定義應用的 Activity 層次結構。 添加對 Android 4.0.3 及更低版本的支持。爲此，請經過添加 meta-data 元素做爲 activity的子項來指定正在啓動的 Activity 的父項。

對於此元素，請設置 android:name="android.support.PARENT_ACTIVITY"。 設置 android:value="<parent_activity_name>"，其中，<parent_activity_name> 是父 <activity> 元素的 android:name 值。請參閱下面的 XML 示例。
複製代碼

一樣添加對 Android 4.1 及更高版本的支持。爲此，請將 android:parentActivityName 屬性添加到正在啓動的 Activity 的 activity 元素中。 最終的 XML 應以下所示：

<activity
    android:name=".MainActivity"
    android:label="@string/app_name" >
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>
<activity
    android:name=".ResultActivity"
    android:parentActivityName=".MainActivity">
    <meta-data
        android:name="android.support.PARENT_ACTIVITY"
        android:value=".MainActivity"/>
</activity>
複製代碼

根據可啓動 Activity 的 Intent 建立返回棧：

建立 Intent 以啓動 Activity。

經過調用 TaskStackBuilder.create() 建立堆棧生成器。 經過調用 addParentStack() 將返回棧添加到堆棧生成器。 對於在清單文件中所定義層次結構內的每一個 Activity，返回棧均包含可啓動 Activity 的 Intent 對象。此方法還會添加一些可在全新任務中啓動堆棧的標誌。 注：儘管 addParentStack() 的參數是對已啓動 Activity 的引用，可是方法調用不會添加可啓動 Activity 的 Intent，而是留待下一步進行處理。

經過調用 addNextIntent()，添加可從通知中啓動 Activity 的 Intent。 將在第一步中建立的 Intent 做爲 addNextIntent() 的參數傳遞。 如需，請經過調用 TaskStackBuilder.editIntentAt() 向堆棧中的 Intent 對象添加參數。有時，須要確保目標 Activity 在用戶使用「返回」導航回它時會顯示有意義的數據。 經過調用 getPendingIntent() 得到此返回棧的 PendingIntent。 而後，您可使用此 PendingIntent 做爲 setContentIntent() 的參數。 如下代碼段演示了該流程：

...
Intent resultIntent = new Intent(this, ResultActivity.class);
TaskStackBuilder stackBuilder = TaskStackBuilder.create(this);
// Adds the back stack
stackBuilder.addParentStack(ResultActivity.class);
// Adds the Intent to the top of the stack
stackBuilder.addNextIntent(resultIntent);
// Gets a PendingIntent containing the entire back stack
PendingIntent resultPendingIntent =
        stackBuilder.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT);
...
NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
builder.setContentIntent(resultPendingIntent);
NotificationManager mNotificationManager =
    (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
mNotificationManager.notify(id, builder.build());
複製代碼

設置特殊 Activity PendingIntent

下文介紹如何設置特殊 Activity PendingIntent。

特殊 Activity 無需返回棧，所以您沒必要在清單文件中定義其 Activity 層次結構，也沒必要調用 addParentStack() 來構建返回棧。取而代之的是，您可以使用清單文件設置 Activity 任務選項，並經過調用 getActivity() 建立 PendingIntent：

在清單文件中，將如下屬性添加到 Activity 的 <activity> 元素
android:name="activityclass"
Activity 的徹底限定類名。
android:taskAffinity=""
與您在代碼中設置的 FLAG_ACTIVITY_NEW_TASK 標誌相結合，這可確保此 Activity 不會進入應用的默認任務。任何具備應用默認關聯的現有任務均不受影響。
android:excludeFromRecents="true"
將新任務從「最新動態」中排除，這樣用戶就不會在無心中導航回它。
如下代碼段顯示了該元素：
<activity
    android:name=".ResultActivity"
...
    android:launchMode="singleTask"
    android:taskAffinity=""
    android:excludeFromRecents="true">
</activity>
...
複製代碼

構建併發出通知：

建立可啓動 Activity的 Intent。 經過使用 FLAG_ACTIVITY_NEW_TASK 和 FLAG_ACTIVITY_CLEAR_TASK 標誌調用 setFlags()，將 Activity 設置爲在新的空任務中啓動。 爲 Intent 設置所需的任何其餘選項。 經過調用 getActivity() 從 Intent 中建立 PendingIntent。 而後，您可使用此 PendingIntent 做爲 setContentIntent() 的參數。 如下代碼段演示了該流程：

// Instantiate a Builder object.
NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
// Creates an Intent for the Activity
Intent notifyIntent =
        new Intent(this, ResultActivity.class);
// Sets the Activity to start in a new, empty task
notifyIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK
                        | Intent.FLAG_ACTIVITY_CLEAR_TASK);
// Creates the PendingIntent
PendingIntent notifyPendingIntent =
        PendingIntent.getActivity(
        this,
        0,
        notifyIntent,
        PendingIntent.FLAG_UPDATE_CURRENT
);

// Puts the PendingIntent into the notification builder
builder.setContentIntent(notifyPendingIntent);
// Notifications are issued by sending them to the
// NotificationManager system service.
NotificationManager mNotificationManager =
    (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
// Builds an anonymous Notification object from the builder, and
// passes it to the NotificationManager
mNotificationManager.notify(id, builder.build());
複製代碼

在通知中顯示進度

通知可能包括動畫形式的進度指示器，向用戶顯示正在進行的操做狀態。 若是您能夠估計操做所需的時間以及任意時刻的完成進度，則使用「限定」形式的指示器（進度欄）。 若是沒法估計操做的時長，則使用「非限定」形式的指示器（Activity 指示器）。

平臺的 ProgressBar 類實現中顯示有進度指示器。

要在 Android 4.0 及更高版本的平臺上使用進度指示器，需調用 setProgress()。對於早期版本，您必須建立包括 ProgressBar 視圖的自定義通知佈局。

下文介紹如何使用 setProgress() 在通知中顯示進度。

顯示持續時間固定的進度指示器 要顯示限定形式的進度欄，請經過調用 setProgress(max, progress, false) 將進度欄添加到通知，而後發出通知。隨着操做繼續進行，遞增 progress 並更新通知。操做結束時， progress 應該等於 max。調用 setProgress() 的常見方法是將 max 設置爲 100，而後將 progress 做爲操做的「完成百分比」值遞增。

您能夠在操做完成後仍保留顯示進度欄，也能夠將其刪除。不管哪一種狀況，都請記住更新通知文本以顯示操做已完成。 要刪除進度欄，請調用 setProgress(0, 0, false)。例如：

...
mNotifyManager =
        (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
mBuilder = new NotificationCompat.Builder(this);
mBuilder.setContentTitle("Picture Download")
    .setContentText("Download in progress")
    .setSmallIcon(R.drawable.ic_notification);
// Start a lengthy operation in a background thread
new Thread(
    new Runnable() {
        @Override
        public void run() {
            int incr;
            // Do the "lengthy" operation 20 times
            for (incr = 0; incr <= 100; incr+=5) {
                    // Sets the progress indicator to a max value, the
                    // current completion percentage, and "determinate"
                    // state
                    mBuilder.setProgress(100, incr, false);
                    // Displays the progress bar for the first time.
                    mNotifyManager.notify(0, mBuilder.build());
                        // Sleeps the thread, simulating an operation
                        // that takes time
                        try {
                            // Sleep for 5 seconds
                            Thread.sleep(5*1000);
                        } catch (InterruptedException e) {
                            Log.d(TAG, "sleep failure");
                        }
            }
            // When the loop is finished, updates the notification
            mBuilder.setContentText("Download complete")
            // Removes the progress bar
                    .setProgress(0,0,false);
            mNotifyManager.notify(ID, mBuilder.build());
        }
    }
// Starts the thread by calling the run() method in its Runnable
).start();
複製代碼

顯示持續 Activity 指示器

要顯示非限定形式的 Activity 指示器，請使用 setProgress(0, 0, true) 將其添加到通知（忽略前兩個參數），而後發出通知。這樣一來，指示器的樣式就與進度欄相同，只是其動畫還在繼續。

在操做開始之際發出通知。除非您修改通知，不然動畫將一直運行。 操做完成後，調用 setProgress(0, 0, false)，而後更新通知以刪除 Activity 指示器。 請務必這樣作；不然，即便操做完成，動畫仍將運行。同時，請記得更改通知文本，以代表操做已完成。

要了解 Activity 指示器的工做方式，請參閱上述代碼段。找到如下幾行：

// Sets the progress indicator to a max value, the current completion
// percentage, and "determinate" state
mBuilder.setProgress(100, incr, false);
// Issues the notification
mNotifyManager.notify(0, mBuilder.build());
將找到的這幾行替換爲如下幾行：

 // Sets an activity indicator for an operation of indeterminate length
mBuilder.setProgress(0, 0, true);
// Issues the notification
mNotifyManager.notify(0, mBuilder.build());
複製代碼

通知元數據

通知可根據您使用如下 NotificationCompat.Builder 方法分配的元數據進行排序：

當設備處於「優先」模式時，setCategory() 會告知系統如何處理應用通知（例如，通知表明傳入呼叫、即時消息仍是鬧鈴）。 若是優先級字段設置爲 PRIORITY_MAX 或 PRIORITY_HIGH 的通知還有聲音或振動，則 setPriority() 會將其顯示在小型浮動窗口中。 addPerson() 容許您向通知添加人員名單。您的應用可使用此名單指示系統將指定人員發出的通知歸成一組，或者將這些人員發出的通知視爲更重要的通知。

圖 3. 顯示浮動通知的全屏 Activity

浮動通知 對於 Android 5.0（API 級別 21），當設備處於活動狀態時（即，設備未鎖定且其屏幕已打開），通知能夠顯示在小型浮動窗口中（也稱爲「浮動通知」）。 這些通知看上去相似於精簡版的通知​​，只是浮動通知還顯示操做按鈕。 用戶能夠在不離開當前應用的狀況下處理或清除浮動通知。

可能觸發浮動通知的條件示例包括：

用戶的 Activity 處於全屏模式中（應用使用 fullScreenIntent），或者 通知具備較高的優先級並使用鈴聲或振動 鎖定屏幕通知 隨着 Android 5.0（API 級別 21）的發佈，通知如今還可顯示在鎖定屏幕上。您的應用可使用此功能提供媒體播放控件以及其餘經常使用操做。 用戶能夠經過「設置」選擇是否將通知顯示在鎖定屏幕上，而且您能夠指定您應用中的通知在鎖定屏幕上是否可見。

設置可見性

您的應用能夠控制在安全鎖定屏幕上顯示的通知中可見的詳細級別。 調用 setVisibility() 並指定如下值之一：

VISIBILITY_PUBLIC 顯示通知的完整內容。 VISIBILITY_SECRET 不會在鎖定屏幕上顯示此通知的任何部分。 VISIBILITY_PRIVATE 顯示通知圖標和內容標題等基本信息，可是隱藏通知的完整內容。 設置 VISIBILITY_PRIVATE 後，您還能夠提供其中隱藏了某些詳細信息的替換版本通知內容。例如，短信 應用可能會顯示一條通知，指出「您有 3 條新短信」，可是隱藏了短信內容和發件人。要提供此替換版本的通知，請先使用 NotificationCompat.Builder 建立替換通知。建立專用通知對象時，請經過 setPublicVersion() 方法爲其附加替換通知。

在鎖定屏幕上控制媒體播放 在 Android 5.0（API 級別 21）中，鎖定屏幕再也不基於 RemoteControlClient（現已棄用）顯示媒體控件。取而代之的是，將 Notification.MediaStyle 模板與 addAction() 方法結合使用，後者可將操做轉換爲可點擊的圖標。

注：該模板和 addAction() 方法未包含在支持庫中，所以這些功能只能在 Android 5.0 及更高版本的系統上運行。

要在 Android 5.0 系統的鎖定屏幕上顯示媒體播放控件，請將可見性設置爲 VISIBILITY_PUBLIC，如上文所述。而後，添加操做並設置 Notification.MediaStyle 模板，如如下示例代碼中所述：

Notification notification = new Notification.Builder(context)
    // Show controls on lock screen even when user hides sensitive content.
    .setVisibility(Notification.VISIBILITY_PUBLIC)
    .setSmallIcon(R.drawable.ic_stat_player)
    // Add media control buttons that invoke intents in your media service
    .addAction(R.drawable.ic_prev, "Previous", prevPendingIntent) // #0
    .addAction(R.drawable.ic_pause, "Pause", pausePendingIntent)  // #1
    .addAction(R.drawable.ic_next, "Next", nextPendingIntent)     // #2
    // Apply the media style template
    .setStyle(new Notification.MediaStyle()
    .setShowActionsInCompactView(1 /* #1: pause button */)
    .setMediaSession(mMediaSession.getSessionToken())
    .setContentTitle("Wonderful music")
    .setContentText("My Awesome Band")
    .setLargeIcon(albumArtBitmap)
    .build();
複製代碼

注：棄用 RemoteControlClient 會對控制媒體產生進一步的影響。如需瞭解有關用於管理媒體會話和控制播放的新 API 的詳細信息，請參閱媒體播放控件。

自定義通知佈局

您能夠利用通知框架定義自定義通知佈局，由該佈局定義通知在 RemoteViews 對象中的外觀。 自定義佈局通知相似於常規通知，可是它們是基於 XML 佈局文件中所定義的 RemoteViews。

自定義通知佈局的可用高度取決於通知視圖。普通視圖佈局限制爲 64 dp，擴展視圖佈局限制爲 256 dp。

要定義自定義通知佈局，請首先實例化 RemoteViews 對象來擴充 XML 佈局文件。而後，調用 setContent()，而不是調用 setContentTitle() 等方法。要在自定義通知中設置內容詳細信息，請使用 RemoteViews 中的方法設置視圖子項的值：

在單獨的文件中爲通知建立 XML 佈局。您能夠根據須要使用任何文件名，但必須使用擴展名 .xml。 在您的應用中，使用 RemoteViews 方法定義通知的圖標和文本。經過調用 setContent() 將此 RemoteViews 對象放入 NotificationCompat.Builder 中。避免在 RemoteViews 對象上設置背景 Drawable，由於文本顏色可能使文本變得難以閱讀。 此外，RemoteViews 類中還有一些方法可供您輕鬆將 Chronometer 或 ProgressBar 添加到通知佈局。如需瞭解有關爲通知建立自定義佈局的詳細信息，請參閱 RemoteViews 參考文檔。

注意：

使用自定義通知佈局時，要特別注意確保自定義佈局適用於不一樣的設備方向和分辨率。 儘管這條建議適用於全部「視圖」佈局，但對通知尤其重要，由於抽屜式通知欄中的空間很是有限。 不要讓自定義佈局過於複雜，同時確保在各類配置中對其進行測試。

對自定義通知文本使用樣式資源 始終對自定義通知的文本使用樣式資源。通知的背景顏色可能因設備和系統版本的不一樣而異，使用樣式資源有助於您充分考慮到這一點。 從 Android 2.3 開始，系統定義了標準通知佈局文本的樣式。若要在面向 Android 2.3 或更高版本系統的多個應用中使用相一樣式，則應確保文本在顯示背景上可見。