### **通知**
**关键类**
* [NotificationManager](https://developer.android.com/reference/android/app/NotificationManager.html)
* [NotificationCompat](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.html)
**视频**
[4.1 中的通知](http://www.youtube.com/watch?v=Yc8YrVc47TI&feature=player_detailpage#t=1672s)
**另请参阅**
[Android 设计：通知](https://developer.android.com/design/patterns/notifications.html)
通知是您可以在应用的常规 UI 外部向用户显示的消息。当您告知系统发出通知时，它将先以图标的形式显示在通知区域中。用户可以打开抽屉式通知栏查看通知的详细信息。 通知区域和抽屉式通知栏均是由系统控制的区域，用户可以随时查看。
:-: 
图 1. 通知区域中的通知。
:-: 
图 2. 抽屉式通知栏中的通知。
> 注：除非特别注明，否则本指南均引用版本 4 支持库中的 [NotificationCompat.Builder](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html) 类。Android 3.0（API 级别 11）中已添加类 [Notification.Builder](https://developer.android.com/reference/android/app/Notification.Builder.html)。
#### **设计注意事项**
作为 Android 用户界面的一个重要组成部分，通知具有自己的设计指导方针。Android 5.0（API 级别 21）中引入的 Material Design 变更尤为重要，您应查阅[Material Design](https://developer.android.com/training/material/index.html)培训资料了解详细信息。 要了解如何设计通知及其交互，请阅读[通知](https://developer.android.com/design/patterns/notifications.html)设计指南。
#### **创建通知**
您可以在 NotificationCompat.Builder 对象中为通知指定 UI 信息和操作。要创建通知，请调用 [NotificationCompat.Builder.build()](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#build())，它将返回包含您的具体规范的 [Notification](https://developer.android.com/reference/android/app/Notification.html) 对象。要发出通知，请通过调用 [NotificationManager.notify()](https://developer.android.com/reference/java/lang/Object.html#notify()) 将 Notification 对象传递给系统。
##### **必需的通知内容**
Notification 对象必须包含以下内容：
* 小图标，由 setSmallIcon() 设置
* 标题，由 setContentTitle() 设置
* 详细文本，由 setContentText() 设置
##### **可选通知内容和设置**
所有其他通知设置和内容都是可选的。如需了解有关它们的更多详情，请参阅 NotificationCompat.Builder 参考文档。
##### **通知操作**
尽管通知操作都是可选的，但是您至少应向通知添加一个操作。 操作允许用户直接从通知转到应用中的 [Activity](https://developer.android.com/reference/android/app/Activity.html)，他们可在其中查看一个或多个事件或执行进一步的操作。
一个通知可以提供多个操作。您应该始终定义一个当用户点击通知时会触发的操作；通常，此操作会在应用中打开 Activity。 您也可以向通知添加按钮来执行其他操作，例如，暂停闹铃或立即答复短信；此功能自 Android 4.1 起可用。如果使用其他操作按钮，则您还必须使这些按钮的功能在应用的 Activity 中可用；请参阅[处理兼容性](https://developer.android.com/guide/topics/ui/notifiers/notifications.html#Compatibility)部分，以了解更多详情。
在 Notification 内部，操作本身由 [PendingIntent](https://developer.android.com/reference/android/app/PendingIntent.html) 定义，后者包含在应用中启动 Activity 的 Intent。要将 PendingIntent 与手势相关联，请调用 NotificationCompat.Builder 的适当方法。例如，如果您要在用户点击抽屉式通知栏中的通知文本时启动 Activity，则可通过调用 [setContentIntent()](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#setContentIntent(android.app.PendingIntent)) 来添加 PendingIntent。
在用户点击通知时启动 Activity 是最常见的操作场景。此外，您还可以在用户清除通知时启动 Activity。在 Android 4.1 及更高版本中，您可以通过操作按钮启动 Activity。如需了解更多信息，请阅读参考指南的 NotificationCompat.Builder 部分。
##### **通知优先级**
您可以根据需要设置通知的优先级。优先级充当一个提示，提醒设备 UI 应该如何显示通知。 要设置通知的优先级，请调用 NotificationCompat.Builder.setPriority() 并传入一个 NotificationCompat 优先级常量。有五个优先级别，范围从 [PRIORITY_MIN](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.html#PRIORITY_MIN) (-2) 到 [PRIORITY_MAX](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.html#PRIORITY_MAX) (2)；如果未设置，则优先级默认为 [PRIORITY_DEFAULT](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.html#PRIORITY_DEFAULT) (0)。
有关设置适当优先级别的信息，请参阅通知设计指南中的“正确设置和管理通知优先级”。
##### **创建简单通知**
以下代码段说明了一个指定某项 Activity 在用户点击通知时打开的简单通知。 请注意，该代码将创建 [TaskStackBuilder](https://developer.android.com/reference/android/support/v4/app/TaskStackBuilder.html) 对象并使用它来为操作创建 PendingIntent。[启动 Activity 时保留导航](https://developer.android.com/guide/topics/ui/notifiers/notifications.html#NotificationResponse)部分对此模式做了更详尽的阐述：
~~~
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()](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#setStyle(android.support.v4.app.NotificationCompat.Style))。
请记住，扩展通知在 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）创建通知。此外，在实现通知时，请遵循以下流程：
1. 为所有用户提供通知的全部功能，无论他们使用何种版本的 Android 系统。 为此，请验证是否可从应用的 Activity 中获得所有功能。要执行此操作，您可能需要添加新的 Activity。
例如，若要使用 addAction() 提供停止和启动媒体播放的控件，请先在应用的 Activity 中实现此控件。
2. 确保所有用户均可通过点击通知启动 Activity 来获得该Activity中的功能。 为此，请为 Activity 创建 PendingIntent。调用 setContentIntent() 以将 PendingIntent 添加到通知。
3. 现在，将要使用的扩展通知功能添加到通知。请记住，您添加的任何功能还必须在用户点击通知时启动的 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，请执行以下步骤：
1. 在清单文件中定义应用的 Activity 层次结构。
* 添加对 Android 4.0.3 及更低版本的支持。为此，请通过添加 [`<meta-data>`](https://developer.android.com/guide/topics/manifest/meta-data-element.html) 元素作为 [`<activity>`](https://developer.android.com/guide/topics/manifest/activity-element.html)的子项来指定正在启动的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>
~~~
2. 根据可启动 Activity 的 Intent 创建返回栈：
* 创建 Intent 以启动 Activity。
* 通过调用 TaskStackBuilder.create() 创建堆栈生成器。
* 通过调用 addParentStack() 将返回栈添加到堆栈生成器。 对于在清单文件中所定义层次结构内的每个 Activity，返回栈均包含可启动 Activity 的 Intent 对象。此方法还会添加一些可在全新任务中启动堆栈的标志。
> 注：尽管 addParentStack() 的参数是对已启动 Activity 的引用，但是方法调用不会添加可启动 Activity 的 Intent，而是留待下一步进行处理。
* 通过调用 [addNextIntent()](https://developer.android.com/reference/android/support/v4/app/TaskStackBuilder.html#addParentStack(android.app.Activity))，添加可从通知中启动 Activity 的 Intent。 将在第一步中创建的 Intent 作为 addNextIntent() 的参数传递。
* 如需，请通过调用 [TaskStackBuilder.editIntentAt()](https://developer.android.com/reference/android/support/v4/app/TaskStackBuilder.html#editIntentAt(int)) 向堆栈中的 Intent 对象添加参数。有时，需要确保目标 Activity 在用户使用“返回”导航回它时会显示有意义的数据。
* 通过调用 [getPendingIntent()](https://developer.android.com/reference/android/support/v4/app/TaskStackBuilder.html#getPendingIntent(int, int)) 获得此返回栈的 PendingIntent。 然后，您可以使用此 PendingIntent 作为 [setContentIntent()](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#setContentIntent(android.app.PendingIntent)) 的参数。
以下代码段演示了该流程：
~~~
...
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](https://developer.android.com/reference/android/app/PendingIntent.html)。
特殊 Activity 无需返回栈，因此您不必在清单文件中定义其 Activity 层次结构，也不必调用 addParentStack() 来构建返回栈。取而代之的是，您可使用清单文件设置 Activity 任务选项，并通过调用 getActivity() 创建 PendingIntent：
1. 在清单文件中，将以下属性添加到 Activity 的 [`<activity>`](https://developer.android.com/guide/topics/manifest/activity-element.html) 元素
* `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>
...
~~~
2. 构建并发出通知：
* 创建可启动 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](https://developer.android.com/reference/android/widget/ProgressBar.html) 类实现中显示有进度指示器。
要在 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 ](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html)方法分配的元数据进行排序：
* 当设备处于“优先”模式时，setCategory() 会告知系统如何处理应用通知（例如，通知代表传入呼叫、即时消息还是闹铃）。
* 如果优先级字段设置为 PRIORITY_MAX 或 PRIORITY_HIGH 的通知还有声音或振动，则 setPriority() 会将其显示在小型浮动窗口中。
* addPerson() 允许您向通知添加人员名单。您的应用可以使用此名单指示系统将指定人员发出的通知归成一组，或者将这些人员发出的通知视为更重要的通知。
#### **浮动通知**
对于 Android 5.0（API 级别 21），当设备处于活动状态时（即，设备未锁定且其屏幕已打开），通知可以显示在小型浮动窗口中（也称为“浮动通知”）。 这些通知看上去类似于精简版的通知，只是浮动通知还显示操作按钮。 用户可以在不离开当前应用的情况下处理或清除浮动通知。
可能触发浮动通知的条件示例包括：
* 用户的 Activity 处于全屏模式中（应用使用 fullScreenIntent），或者
* 通知具有较高的优先级并使用铃声或振动
:-: 
图 3. 显示浮动通知的全屏 Activity
#### **锁定屏幕通知**
随着 Android 5.0（API 级别 21）的发布，通知现在还可显示在锁定屏幕上。您的应用可以使用此功能提供媒体播放控件以及其他常用操作。 用户可以通过“设置”选择是否将通知显示在锁定屏幕上，并且您可以指定您应用中的通知在锁定屏幕上是否可见。
#### **设置可见性**
您的应用可以控制在安全锁定屏幕上显示的通知中可见的详细级别。 调用 [setVisibility()](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#setVisibility(int)) 并指定以下值之一：
* [VISIBILITY_PUBLIC](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.html#VISIBILITY_PUBLIC) 显示通知的完整内容。
* [VISIBILITY_SECRET](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.html#VISIBILITY_SECRET) 不会在锁定屏幕上显示此通知的任何部分。
* [VISIBILITY_PRIVATE](https://developer.android.com/reference/android/support/v4/app/NotificationCompat.html#VISIBILITY_PRIVATE) 显示通知图标和内容标题等基本信息，但是隐藏通知的完整内容。
设置 VISIBILITY_PRIVATE 后，您还可以提供其中隐藏了某些详细信息的替换版本通知内容。例如，短信 应用可能会显示一条通知，指出“您有 3 条新短信”，但是隐藏了短信内容和发件人。要提供此替换版本的通知，请先使用 NotificationCompat.Builder 创建替换通知。创建专用通知对象时，请通过 setPublicVersion() 方法为其附加替换通知。
#### **在锁定屏幕上控制媒体播放**
在 Android 5.0（API 级别 21）中，锁定屏幕不再基于 [RemoteControlClient](https://developer.android.com/reference/android/media/RemoteControlClient.html)（现已弃用）显示媒体控件。取而代之的是，将 [Notification.MediaStyle](https://developer.android.com/reference/android/app/Notification.MediaStyle.html) 模板与 [addAction()](https://developer.android.com/reference/android/app/Notification.Builder.html#addAction(android.app.Notification.Action)) 方法结合使用，后者可将操作转换为可点击的图标。
> 注：该模板和 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 的详细信息，请参阅[媒体播放控件](https://developer.android.com/about/versions/android-5.0.html#MediaPlaybackControl)。
#### **自定义通知布局**
您可以利用通知框架定义自定义通知布局，由该布局定义通知在 [RemoteViews](https://developer.android.com/reference/android/widget/RemoteViews.html) 对象中的外观。 自定义布局通知类似于常规通知，但是它们是基于 XML 布局文件中所定义的 RemoteViews。
自定义通知布局的可用高度取决于通知视图。普通视图布局限制为 64 dp，扩展视图布局限制为 256 dp。
要定义自定义通知布局，请首先实例化 RemoteViews 对象来扩充 XML 布局文件。然后，调用 setContent()，而不是调用 setContentTitle() 等方法。要在自定义通知中设置内容详细信息，请使用 RemoteViews 中的方法设置视图子项的值：
1. 在单独的文件中为通知创建 XML 布局。您可以根据需要使用任何文件名，但必须使用扩展名 .xml。
2. 在您的应用中，使用 RemoteViews 方法定义通知的图标和文本。通过调用 setContent() 将此 RemoteViews 对象放入 NotificationCompat.Builder 中。避免在 RemoteViews 对象上设置背景 [Drawable](https://developer.android.com/reference/android/graphics/drawable/Drawable.html)，因为文本颜色可能使文本变得难以阅读。
此外，RemoteViews 类中还有一些方法可供您轻松将 [Chronometer](https://developer.android.com/reference/android/widget/Chronometer.html) 或 [ProgressBar](https://developer.android.com/reference/android/widget/ProgressBar.html) 添加到通知布局。如需了解有关为通知创建自定义布局的详细信息，请参阅 RemoteViews 参考文档。
> **注意**：使用自定义通知布局时，要特别注意确保自定义布局适用于不同的设备方向和分辨率。 尽管这条建议适用于所有“视图”布局，但对通知尤为重要，因为抽屉式通知栏中的空间非常有限。 不要让自定义布局过于复杂，同时确保在各种配置中对其进行测试。
#### **对自定义通知文本使用样式资源**
始终对自定义通知的文本使用样式资源。通知的背景颜色可能因设备和系统版本的不同而异，使用样式资源有助于您充分考虑到这一点。 从 Android 2.3 开始，系统定义了标准通知布局文本的样式。若要在面向 Android 2.3 或更高版本系统的多个应用中使用相同样式，则应确保文本在显示背景上可见。
- 前言
- Google官网对Android API各版本的介绍
- jelly Bean（果冻豆）Android 4.1、4.2、4.3
- Android 4.1
- Android 4.2
- Android 4.3
- KitKat（Android 4.4.*）巧克力
- Android 4.4 APIS
- Lollipop（棒棒糖）Android 5.*
- Android 5.0 APIs
- Android 5.0 Changes（变更）
- Android 5.1APIs
- Marshmallow（棉花糖）Android 6.0
- Android 6.0 APIs
- Android 6.0 Changes（变更）
- Android 6.0 Samples
- Android 6.0 Testing
- Nougat（牛扎塘）Android 7.*
- Android 7.0
- API
- 行为变更
- 示例
- Android 7.1
- 开发者API
- 示例Sample
- Oreo（奥利奥）8.*
- Android 8.0
- 功能和 API
- Android 8.0 行为变更
- 向 Android 8.0 迁移应用
- Android 8.0 示例
- Android 8.1
- 后台执行限制
- 后台位置限制
- API指南
- Android 简介
- 应用基础知识
- 设备兼容性
- 系统权限
- 请求权限
- 定义权限
- 平台架构
- Java8 概览
- 在ART上验证应用行为
- 应用组件
- Intent 和 Intent 过滤器（Google官网介绍）
- 通用intent
- Activity
- 任务和返回栈（官网译文）
- 概览屏幕
- 活动简介
- 活动生命周期
- 活动状态更改
- 进程和应用程序生命周期
- 包裹和捆绑
- 最近的屏幕
- 片段
- 加载器
- 服务Service
- 绑定服务
- AIDL
- 内容提供程序
- 内容提供程序基础知识
- 创建内容提供程序
- 日历提供程序
- 联系人提供程序
- 存储访问框架
- 使用存储访问框架打开文件
- 创建自定义文档提供程序
- 应用小部件
- 应用小部件主机
- 进程和线程
- 应用资源
- 概览
- 提供资源
- 访问资源
- 处理运行时变更
- 本地化
- ICU4J Android框架API
- Android上的国际化
- 语言和语言区域
- 复杂的XML资源
- 资源类型
- 动画
- 颜色状态列表
- 可绘制对象
- 布局
- 菜单
- 字符串
- 样式
- 其他类型
- 应用清单
- <action>
- <activity>
- <activity-alias>
- <application>
- <category>
- <compatiable-screens>
- <data>
- <grant-uri-permission>
- <intent-filter>
- <manifest>
- <meta-data>
- <path-permission>
- <permission>
- <permission-group>
- <permission-tree>
- <provider>
- <receiver>
- <service>
- <supporte-gl-texture>
- <supports-screens>
- <uses-configuration>
- <uses-feature>
- <uses-library>
- <uses-permission>
- <uses-permission-sdk-23>
- <uses-sdk>
- 用户界面
- 界面概览
- 界面布局
- 线性布局
- 相对布局
- 列表视图
- 网格视图
- 回收站视图
- 外观和感觉
- 可下载的字体
- XML中的字体
- 表情符号兼容性
- 自动调整TextView
- 样式和主题-
- 输入控件
- 按钮
- 文本字段
- 复选框
- 单选按钮
- 切换按钮
- 微调框
- 选取器
- 输入事件
- 菜单Menu
- 设置
- 对话框
- 通知
- Toast
- 自适应图标
- 应用快捷方式
- 搜索
- 创建搜索界面
- 添加近期查询建议
- 添加自定义建议
- 可搜索配置
- 多窗口支持
- 拖放
- 无障碍功能
- 为应用设置无障碍功能
- 无障碍功能开发者检查单
- 构建无障碍服务
- 让应用更容易访问
- 使用节点树调试
- 构建可访问自定义视图
- 样式和主题
- 自定义组件
- 动画和图形
- 概览介绍
- 属性动画
- 视图动画
- 可绘制动画
- 画布和可绘制对象
- 基于物理的动画
- Spring Animation
- Fling Animation
- OpenGL ES
- 硬件加速
- 计算
- RenderScript
- 高级RenderScript
- Runtime API Reference（参考）
- Numerical Types（数字类型）
- Object Types（对象类型）
- Conversion Functions（转换函数）
- Mathematical Constants and Functions（数学常量和函数）
- Vector Math Functions（矢量数学函数）
- Matrix Functions（矩阵函数）
- Quaternion Functions（四元数函数）
- Atomic Update Functions（原子更新函数）
- Time Functions and Types（时间函数和类型）
- Allocation Data Access Functions（分配数据访问函数）
- Object Characteristics Functions（对象特性函数）
- Kernel Invocation Functions and Types（内核调用函数和类型）
- Input/Output Functions（输入输出函数）
- Debugging Functions（调试函数）
- Graphics Functions and Types（图形函数和类型）
- Index（索引）
- Media Apps（媒体应用）
- Media Apps Overview（媒体应用程序概述）
- Working with a Media Session（使用媒体会话）
- Building an Audio App（建立一个音频应用）
- Building a Media Browser Service（构建媒体浏览器服务）
- Building a Media Browser Client（构建媒体浏览器客户端）
- Media Session Callbacks（媒体会话回调）
- Building a Video App（建立一个视频应用）
- Building a Video Player Activity（建立一个视频播放器Activity）
- Media Session Callbacks-（媒体会话回调）
- Responding to Media Buttons（响应媒体按钮）
- Handling Changes in Audio Output（处理音频输出的变化）
- Managing Audio Focus（管理音频焦点）
- The Google Assistant and Media Apps（Google智能助理和媒体应用）
- 媒体和相机
- Supported Media Formats（支持的媒体格式）
- MediaPlayer（媒体播放器）
- MediaRecorder
- ExoPlayer
- Controller Amplitude with VolumeShaper（VolumeShaper控制器振幅）
- Media Routing（媒体路由）
- MediaRouter API
- MediaRouteProvider API
- Camera API（相机API）
- 位置和传感器
- Location and Maps（位置和地图）
- Location Strategies（位置策略）
- Sensors Overview（传感器概览）
- Motion Sensors（运动传感器）
- Position Sensors（位置传感器）
- Environment Sensors（环境传感器）
- Raw GNSS Measurements（原始的GNSS测量）
- 连接
- Bluetooth
- Bluetooth Low Energy（蓝牙低功耗）
- NFC
- NFC Basics（NFC基础知识）
- Advanced NFC（高级NFC）
- Host-based Card Emulation（基于主机的卡模拟）
- Telecom（电信）
- Self-Managed ConnectionServices（自我管理的连接服务）
- Wi-Fi P2P
- Wi-Fi Aware
- Companion Device Pairing
- USB
- Accessory（配件）
- Host（主机）
- SIP
- 文本和输入
- Autofill Framework（自动填充框架）
- Test your app with autofill（使用自动填充测试你的应用）
- Building autofill services（构建自动填充服务）
- Copy and Paste（复制和粘贴）
- Creating an IME（创建IME）
- Image Keyboard（图像键盘）
- Spelling Checker（拼写检查程序）
- 数据存储
- Storage Options（存储选项）
- Data Backup（数据备份）
- Account Transfer API（账户转移API）
- Auto Backup（自动备份）
- Key/Value Backup（键值备份）
- Testing Backup and Restore（测试备份和还原）
- App Install Location（应用安装位置）
- 库
- 支持库
- 功能
- 修订历史记录
- 库设置
- 数据绑定库
- 测试支持库
- 管理
- 设备策略
- 网络应用
- Supporting Different Screens in Web Apps（在网络应用中支持不同屏幕）
- Building Web Apps in WebView（在WebView中构建网络应用）
- Managing WebViews
- Migrating to WebView in Android 4.4（迁移到Android4.4中的WebView）
- Debugging Web Apps（调试网络应用）
- Best Practices for Web Apps（网络应用最佳做法）
- 最佳实践
- Supporting Multiple Screens（支持多种屏幕）
- Distributing to Specific Screens（分配到特定屏幕）
- Screen Compatibility Mode（屏幕兼容性模式）
- Designing for Seamlessness
- Supporting Tablets and Handsets
- 培训