通知系统使用户得知应用中重要的事情,例如有新信息到来或者日历事件提醒。将通知作为一个新的通道,提醒用户重要的事情或者记录下用户没有注意到的事情。
具体见中文开发者文档
Jelly Bean 以后,8.0以前版本的通知:
- 通知可以包含操作,使用户可以在通知抽屉中直接作出回应。
- 通知在大小和布局方面更加灵活,可以展开以显示更多信息。
- 新的优先级标志让通知可以按照重要程度排序,而不仅仅只是按照时间顺序。
创建一个通知:
fun createNotification(view: View) {
val builder = NotificationCompat.Builder(this)
val bitmap = BitmapFactory.decodeResource(resources, R.mipmap.ic_launcher)
//设置大图标
builder.setLargeIcon(bitmap)
//设置小图标
builder.setSmallIcon(R.drawable.depu)
//设置标题
builder.setContentTitle("这是标题,id=$id")
//设置正文
builder.setContentText("这是正文")
//设置摘要
builder.setSubText("这是摘要")
//显示指定文本
builder.setContentInfo("这是info")
//设置是否点击消息后自动clean
builder.setAutoCancel(true)
//可以设置对消息的计数,位置和setContentInfo一样,设置setContentInfo过则setNumber失效
builder.setNumber(msgNumbe)
//状态栏显示时的文本
builder.setTicker("在状态栏上显示的文本")
//设置优先级,影响出现在通知栏的排序
builder.priority = NotificationCompat.PRIORITY_HIGH
//设置显示的时间,可以自定义
builder.setWhen(System.currentTimeMillis())
//true代表正在进行的通知,此时用户无法清除通知
builder.setOngoing(true)
//设置消息的提醒方式,震动提醒:DEFAULT_VIBRATE 声音提醒:NotificationCompat.DEFAULT_SOUND
//三色灯提醒NotificationCompat.DEFAULT_LIGHTS 以上三种方式一起:DEFAULT_ALL
builder.setDefaults(NotificationCompat.DEFAULT_SOUND)
//设置震动方式,延迟零秒,震动一秒,延迟一秒、震动一秒
builder.setVibrate(longArrayOf(0, 1000, 1000, 1000))
val intent = Intent(this, ShowActivity::class.java)
intent.putExtra(INTENT_KEY, id)
val pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT)
//设置意图
builder.setContentIntent(pendingIntent)
val notificationManager: NotificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
notificationManager.notify(id, builder.build())
id++
msgNumbe++
}
如果我连续点击5次,那么每一个通知点进去,intent传递过来的参数都是最后一个,这个后面再说。
注意:
notificationManager.notify(id, builder.build())
这里的id代表着通知栏的通知是不是同一个,如果id一样,只会显示一个通知。
创建一个显示多行文本的通知:
val builder = NotificationCompat.Builder(this)
val bitmap = BitmapFactory.decodeResource(resources, R.mipmap.ic_launcher)
//设置大图标
builder.setLargeIcon(bitmap)
//设置小图标
builder.setSmallIcon(R.drawable.depu)
//设置标题
builder.setContentTitle("这是标题,id=$id")
//设置正文
builder.setContentText("这是正文")
//显示许多文本,最对12行。部分机型不支持。
val bigTextStyle = NotificationCompat.BigTextStyle()
bigTextStyle.bigText("如果已经有正在等待处理的相同类型通知了,那么你的应用不应当再创建一条新的通知,而是将多条通知合并。合并的通知提供了总体的信息描述,并且告知用户有多少条通知正在等待处理。")
bigTextStyle.setBigContentTitle("多文本时候的标题")
//许多文本时候的摘要
bigTextStyle.setSummaryText("这是摘要")
builder.setStyle(bigTextStyle)
大多时候的通知,需要很多条,并且点击后获得意图的携带参数都市不一样的。
PendingIntent的flag取值有四个:
- FLAG_ONE_SHOT:获取的PendingIntent只能使用一次
- FLAG_NO_CREATE:利用FLAG_NO_CREAT获取的PendingIntent,若描述的Intent不存在则返回NULL值
- FLAG_CANCEL_CURRENT:如果描述的PendingIntent已经存在,则在产生新的Intent之前会先取消掉当前的
- FLAG_UPDATE_CURRENT:能够新new一个 Intent
比如demo里的id每次都增加,但是获取到的id显示规则如下:
val intent = Intent(this, ShowActivity::class.java)
intent.putExtra(INTENT_KEY, id)
val pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT)
点击两次发出2个通知,id分别是1,2:
flag | requestCode | 结果 | 备注 |
---|---|---|---|
FLAG_ONE_SHOT | 不变 | 先id为1的通知获取到1,再点击id为2的通知,通知消失,没有跳转。 先id为2的通知获取到1,再点击id为1的通知,通知消失,没有跳转。 |
只能获取最早的数据 |
FLAG_ONE_SHOT | 不同 | 先id为1的通知获取到1,再点击id为2的通知获取获取到2 先id为2的通知获取到2,再点击id为1的通知获取获取到1, |
能正确获取数据 |
FLAG_NO_CREATE | 不变 | 先id为1的通知无反应,再点击id为2的通知无反应 先id为2的通知无反应,再点击id为1的通知无反应 |
无反应 |
FLAG_NO_CREATE | 不同 | 先id为1的通知无反应,再点击id为2的通知无反应 先id为2的通知无反应,再点击id为1的通知无反应 |
无反应 |
FLAG_CANCEL_CURRENT | 不变 | 先id为1的通知,通知消失,不跳转,再点击id为2的通知获取获取到2 先id为2的通知获取到2,再点击id为1的通知,通知消失,不跳转 |
最新的通知能正确获取数据 |
FLAG_CANCEL_CURRENT | 不同 | 先id为1的通知获取到1,再点击id为2的通知获取获取到2 先id为2的通知获取到2,再点击id为1的通知获取获取到1, |
能正确获取数据 |
FLAG_UPDATE_CURRENT | 不变 | 先id为1的通知获取到2,再点击id为2的通知获取获取到2 先id为2的通知获取到2,再点击id为1的通知获取获取到2, |
只能获取到最新的数据 |
FLAG_UPDATE_CURRENT | 不同 | 先id为1的通知获取到1,再点击id为2的通知获取获取到2 先id为2的通知获取到2,再点击id为1的通知获取获取到1, |
能正确获取数据 |