修改通知徽章

从 Android 8.0(API 级别 26)开始,当关联应用有活动通知时,通知徽章(也称为通知圆点)会出现在启动器图标上。用户可以触摸并按住应用图标以显示通知以及任何应用快捷方式,如图 1 所示。

这些圆点默认会出现在支持它们的启动器应用中,您的应用无需执行任何操作。但是,在某些情况下,您可能不希望显示通知圆点,或者您想精确控制哪些通知会出现在那里。

图 1. 通知徽章和触摸并按住菜单。

停用徽章

在某些情况下,徽章对您的通知没有意义,因此您可以通过在 NotificationChannel 对象上调用 setShowBadge(false) 按渠道停用徽章。

例如,您可能希望在以下情况下停用通知徽章

  • 正在进行的通知:大多数正在进行的通知,例如图像处理、媒体播放控件或当前导航指示,作为徽章没有意义。
  • 日历提醒:避免为当前发生的事件添加徽章。
  • 时钟或闹钟事件:避免为与当前闹钟相关的通知添加徽章。

以下示例代码演示了如何隐藏通知渠道的徽章

Kotlin

val id = "my_channel_01"
val name = getString(R.string.channel_name)
val descriptionText = getString(R.string.channel_description)
val importance = NotificationManager.IMPORTANCE_LOW
val mChannel = NotificationChannel(id, name, importance).apply {
    description = descriptionText
    setShowBadge(false)
}
val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
notificationManager.createNotificationChannel(mChannel)

Java

String id = "my_channel_01";
CharSequence name = getString(R.string.channel_name);
String description = getString(R.string.channel_description);
int importance = NotificationManager.IMPORTANCE_LOW;
NotificationChannel mChannel = new NotificationChannel(id, name, importance);
mChannel.setDescription(description);
mChannel.setShowBadge(false);

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

设置自定义通知计数

默认情况下,每个通知都会使触摸并按住菜单上显示的数字(如图 1 所示)加一,但您可以为应用替换此数字。例如,如果您仅使用一个通知来表示多个新消息,但希望计数表示总的新消息数量,这可能会很有用。

要设置自定义数字,请在通知上调用 setNumber(),如下所示

Kotlin

var notification = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID)
        .setContentTitle("New Messages")
        .setContentText("You've received 3 new messages.")
        .setSmallIcon(R.drawable.ic_notify_status)
        .setNumber(messageCount)
        .build()

Java

Notification notification = new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID)
        .setContentTitle("New Messages")
        .setContentText("You've received 3 new messages.")
        .setSmallIcon(R.drawable.ic_notify_status)
        .setNumber(messageCount)
        .build();

修改通知的触摸并按住菜单图标

触摸并按住菜单会显示与通知关联的大图标或小图标(如果可用)。默认情况下,系统会显示大图标,但您可以调用 Notification.Builder.setBadgeIconType() 并传入 BADGE_ICON_SMALL 常量来显示小图标。

Kotlin

var notification = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID)
        .setContentTitle("New Messages")
        .setContentText("You've received 3 new messages.")
        .setSmallIcon(R.drawable.ic_notify_status)
        .setBadgeIconType(NotificationCompat.BADGE_ICON_SMALL)
        .build()

Java

Notification notification = new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID)
        .setContentTitle("New Messages")
        .setContentText("You've received 3 new messages.")
        .setSmallIcon(R.drawable.ic_notify_status)
        .setBadgeIconType(NotificationCompat.BADGE_ICON_SMALL)
        .build();

隐藏重复的快捷方式

如果您的应用创建的通知与应用快捷方式重复,您可以在通知处于活动状态时通过调用 setShortcutId() 暂时隐藏该快捷方式。

如需查看更多使用通知的示例代码,请参阅 SociaLite 示例应用