Android Support v4 包中的 NotificationCompat.Builder ，在 Android 3.0 API Level 11 中才有 Notification.Builder。

创建通知

您可以在 NotificationCompat.Builder 对象中为通知指定 UI 信息和操作。要创建通知，请调用 NotificationCompat.Builder.build()，它将返回包含您的具体规范的 Notification 对象。要发出通知，请通过调用 NotificationManager.notify() 将 Notification 对象传递给系统。

必需的通知内容

Notification 对象必须包含以下内容：

  • 小图标，由 setSmallIcon() 设置
  • 标题，由 setContentTitle() 设置
  • 详细文本，由 setContentText() 设置

setContentIntent() 设置用户点击通知之后的动作。

NotificationCompat.Builder 在构造时自动设置时间为 System.currentTimeMillis() ，设置 Audio stream 为 STREAM_DEFAULT。

NotificationCompat.Builder 中可选的其他参数有

  • setAutoCancel() 设置通知是否自动消失
  • setLargeIcon(Bitmap icon) 设置大图标
  • setTicker() 设置通知第一次到达时在status bar 上显示的文字，在Android L版本之后不再显示
  • setLights() 设置通知呼吸灯的颜色以及频率
  • setDeleteIntent() 设置用户直接在通知列表删除通知时的动作
  • setAction() 设置通知中的动作

重要类

NotificationCompat.Builder 不必多说，其他重要的类有 NotificationCompat.Action 通知动作需要包含一个图标，一个标签，一个 PendingIntent 。通知动作在 Android 4.1 之前不会显示。

如果要在通知栏显示复杂View，需要设定 RemoteView，使用 setContent(RemoteViews views) 方法

NotificationCompat.Style 用来展现更丰富的通知内容的样式，直接子类有

  • NotificationCompat.BigPictureStyle
  • NotificationCompat.BigTextStyle
  • NotificationCompat.InboxStyle
  • NotificationCompat.MediaStyle

BigPictureStyle 可以显示大图，如果通知附带一张大图片，可以使用该样式。通常 Android 截屏之后显示的通知就是。

Notification notif = new Notification.Builder(mContext)
     .setContentTitle("New photo from " + sender.toString())
     .setContentText(subject)
     .setSmallIcon(R.drawable.new_post)
     .setLargeIcon(aBitmap)
     .setStyle(new Notification.BigPictureStyle()
         .bigPicture(aBigBitmap))
     .build();

InboxStyle 可以产生多行文本的通知，至多可以显示5个字符串。

Notification noti = new Notification.Builder()
     .setContentTitle("5 New mails from " + sender.toString())
     .setContentText(subject)
     .setSmallIcon(R.drawable.new_mail)
     .setLargeIcon(aBitmap)
     .setStyle(new Notification.InboxStyle()
         .addLine(str1)
         .addLine(str2)
         .setContentTitle("")
         .setSummaryText("+3 more"))
     .build();

还有可以显示很多文字的 BigTextStyle，和比较复杂的 MediaStyle。

Android 4.4 以下的通知

android notification

android notification expand

Android 5.0 及以上的通知

android notification 5

reference