创建一个通知组

从 Android 7.0(API 级别 24)开始,您可以将相关的通知显示在一个组中。例如,如果您的应用显示收到的电子邮件通知,请将所有新电子邮件消息的通知放在同一组中,以便它们一起折叠。

为了支持旧版本,请添加一个单独显示的摘要通知以总结所有单独的通知。这通常最好使用收件箱样式通知完成。

图 1. 折叠的(顶部)和展开的(底部)通知组。

如果您的用例满足以下所有条件,请使用通知组

  • 子通知是完整的通知,可以单独显示,无需组摘要。

  • 单独显示子通知是有益的。例如

    • 它们是可操作的,每个通知都有特定操作。

    • 每个通知都有更多信息供用户查看。

如果您的通知不符合上述标准,请考虑使用更新现有通知中的新信息或创建一个消息样式通知以在同一会话中显示多个更新。

创建一个组并向其中添加通知

要创建通知组,请为该组定义一个唯一的标识符字符串。然后,对于要放入该组的每个通知,调用setGroup(),并传入组名。例如

Kotlin

val GROUP_KEY_WORK_EMAIL = "com.android.example.WORK_EMAIL"

val newMessageNotification = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID)
        .setSmallIcon(R.drawable.new_mail)
        .setContentTitle(emailObject.getSenderName())
        .setContentText(emailObject.getSubject())
        .setLargeIcon(emailObject.getSenderAvatar())
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build()

Java

String GROUP_KEY_WORK_EMAIL = "com.android.example.WORK_EMAIL";

Notification newMessageNotification = new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID)
        .setSmallIcon(R.drawable.new_mail)
        .setContentTitle(emailObject.getSenderName())
        .setContentText(emailObject.getSubject())
        .setLargeIcon(emailObject.getSenderAvatar())
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build();

默认情况下,通知会根据发布的时间进行排序,但您可以通过调用setSortKey()来更改顺序。

如果通知组的警报必须由不同的通知处理,请调用setGroupAlertBehavior()。例如,如果您只想让组的摘要发出声音,则组中的所有子项都必须具有组警报行为GROUP_ALERT_SUMMARY。其他选项是GROUP_ALERT_ALLGROUP_ALERT_CHILDREN

设置组摘要

分组通知必须有一个额外的通知作为组摘要。要启用分组通知,您必须设置组摘要。此组摘要必须包含组中每个其他通知的一些文本,以帮助用户了解组中的内容。组摘要的显示方式取决于Android版本

  • 在低于 7.0(API 级别 24)的 Android 版本上(无法显示嵌套的通知组),系统仅显示您的组摘要通知并隐藏所有其他通知。用户可以点击组摘要通知以打开您的应用。

  • 在 Android 7.0 及更高版本上,系统会将您的组摘要通知显示为嵌套的通知组,并用每个分组通知中的文本片段进行标记。它不会显示您在组摘要通知上设置的文本。用户可以展开嵌套的通知组以查看组中的单个通知,如图 1 所示。

即使更新版本的 Android 不会显示您设计的组摘要文本,您也始终需要手动设置摘要才能启用分组通知。组摘要的行为在某些设备类型(例如可穿戴设备)上可能会有所不同。在您的组摘要上设置丰富的內容有助于在所有设备和版本上提供最佳体验。

要添加组摘要,请执行以下步骤

  1. 创建一个新的通知,其中包含对组的描述——通常最好使用收件箱样式通知

  2. 通过调用setGroup()将摘要通知添加到组中。

  3. 通过调用setGroupSummary(true)指定必须将其用作组摘要。

以下代码显示了创建组摘要的示例

Kotlin

// Use constant ID for notifications used as group summary.
val SUMMARY_ID = 0
val GROUP_KEY_WORK_EMAIL = "com.android.example.WORK_EMAIL"

val newMessageNotification1 = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_notify_email_status)
        .setContentTitle(emailObject1.getSummary())
        .setContentText("You will not believe...")
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build()

val newMessageNotification2 = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_notify_email_status)
        .setContentTitle(emailObject2.getSummary())
        .setContentText("Please join us to celebrate the...")
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build()

val summaryNotification = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID)
        .setContentTitle(emailObject.getSummary())
        // Set content text to support devices running API level < 24.
        .setContentText("Two new messages")
        .setSmallIcon(R.drawable.ic_notify_summary_status)
        // Build summary info into InboxStyle template.
        .setStyle(NotificationCompat.InboxStyle()
                .addLine("Alex Faarborg Check this out")
                .addLine("Jeff Chang Launch Party")
                .setBigContentTitle("2 new messages")
                .setSummaryText("[email protected]"))
        // Specify which group this notification belongs to.
        .setGroup(GROUP_KEY_WORK_EMAIL)
        // Set this notification as the summary for the group.
        .setGroupSummary(true)
        .build()

NotificationManagerCompat.from(this).apply {
    notify(emailNotificationId1, newMessageNotification1)
    notify(emailNotificationId2, newMessageNotification2)
    notify(SUMMARY_ID, summaryNotification)
}

Java

// Use constant ID for notifications used as group summary.
int SUMMARY_ID = 0;
String GROUP_KEY_WORK_EMAIL = "com.android.example.WORK_EMAIL";

Notification newMessageNotification1 =
    new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_notify_email_status)
        .setContentTitle(emailObject1.getSummary())
        .setContentText("You will not believe...")
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build();

Notification newMessageNotification2 =
    new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_notify_email_status)
        .setContentTitle(emailObject2.getSummary())
        .setContentText("Please join us to celebrate the...")
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build();

Notification summaryNotification =
    new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID)
        .setContentTitle(emailObject.getSummary())
        // Set content text to support devices running API level < 24.
        .setContentText("Two new messages")
        .setSmallIcon(R.drawable.ic_notify_summary_status)
        // Build summary info into InboxStyle template.
        .setStyle(new NotificationCompat.InboxStyle()
                .addLine("Alex Faarborg  Check this out")
                .addLine("Jeff Chang    Launch Party")
                .setBigContentTitle("2 new messages")
                .setSummaryText("[email protected]"))
        // Specify which group this notification belongs to.
        .setGroup(GROUP_KEY_WORK_EMAIL)
        // Set this notification as the summary for the group.
        .setGroupSummary(true)
        .build();

NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
notificationManager.notify(emailNotificationId1, newMessageNotification1);
notificationManager.notify(emailNotificationId2, newMessageNotification2);
notificationManager.notify(SUMMARY_ID, summaryNotification);

摘要通知 ID 必须保持不变,以便仅发布一次,并且以便您稍后在摘要信息更改时更新它。对组的后续添加必须导致更新现有的摘要。

有关使用通知的示例代码,请参阅Android 通知示例

自动分组

在 Android 7.0(API 级别 24)及更高版本上,如果您的应用发送通知并且未指定组密钥或组摘要,则系统可能会自动将它们分组在一起。自动分组的通知会显示带有组摘要通知,该通知用一些分组通知的文本片段标记。用户可以展开此摘要通知以查看每个单独的通知,就像手动分组的通知一样。

自动分组行为在某些设备类型上可能会有所不同。为了在所有设备和版本上提供最佳体验,如果您知道必须对通知进行分组,请指定组密钥和组摘要以确保对它们进行分组。