Android Notification使用

一 Notification的类别

1.状态栏和抽屉式通知

  //获取NotificationManager对象
  val notificationManager = getSystemService(NOTIFICATION_SERVICE) as NotificationManager

  val intent = Intent(NotificationActivity@this,MainActivity::class.java)
  //PendingIntent.FLAG_ONE_SHOT 多次创建也只能使用一次
  val pendingIntent = PendingIntent.getActivity(NotificationActivity@this,0,intent,PendingIntent.FLAG_ONE_SHOT)

  //通道id 该id需要和创建NotificationChannel指定的id一致
  val channelId = "komine.demos.app"

  //创建Notification对象
  val notification = Notification.Builder(NotificationActivity@this,channelId) //channelId
            //通知的文字内容
            .setContentTitle("NotificationContentTitle")
            //通知的正文内容
	    .setContentText("NotificationContent")
            //Android8.0+提供的badge通知数字,默认只会显示一个圆点,需要长按应用图标才能看到设置的数字
            .setNumber(39)
            //pendingIntent 提供点击通知之后执行的动作,比如打开一个Activity
            .setContentIntent(pendingIntent)
            //设置通知左上角显示的图标,该图标不能太大,否则不正常显示,而且要是纯色的
            .setSmallIcon(R.mipmap.notification)
            //通知的大图标
            .setLargeIcon(BitmapFactory.decodeResource(resources,R.mipmap.ic_launcher))
	    //.setContent() //已过时,换成setCustomContentView() 设置自定义的布局View
            //设置自定义布局
	    .setCustomContentView()
            ////设置为true,当用户点击的时候自动消失
	    .setAutoCancel(false)
            //设置左上角图片的颜色 即setSmallIcon图片的颜色
	    .setColor(Color.RED)
	    //可以理解为内容的样式,比如要放一张图片,一段文字或者媒体播放控制等,效果见下图
	    .setStyle(Notification.BigPictureStyle().bigPicture(bitmap))
            //显示一个进度条,参数1:最大值,参数2:当前进度,参数3:循环效果
	    .setProgress(100,39,false)
            .build()

  //如果运行在Android8.0+ 需要指定NotificationChannel,并且在Notification.Builder中指定指定channelId
  if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.O){
        //在8.0+需要创建一个通知渠道,才能发送通知
        val notificationChannel = NotificationChannel(channelId,"一般通知",NotificationManager.IMPORTANCE_HIGH)
        notificationManager.createNotificationChannel(notificationChannel)
  }

  //最后调用notify方法显示通知 参数一:tag可以随便填,参数二:通知的重要级别,参数三:Notification对象
  notificationManager.notify("",NotificationManager.IMPORTANCE_NONE,notification)

  .setProgress(100,39,false)

  .setProgress(100,39,true)

  .setNumber(39)

  .setColor(Color.RED)

  .setStyle(Notification.BigPictureStyle().bigPicture(BitmapFactory.decodeResource(resources,R.mipmap.miku)))

  .setStyle(Notification.BigTextStyle().bigText("这是一段很长很长很长很长很长很长很长很长很长很长很长很长很长很长很长很长很长很长很长很长很长很长的文字"))

2.提醒式通知/顶部悬浮通知

跟一般通知的用法一致

Android8.0+ 在创建NotificationChannel的时候指定为 NotificationManager.IMPORTANCE_HIGH

  val notificationChannel = NotificationChannel(channelId,"一般通知",NotificationManager.IMPORTANCE_HIGH)

Android8.0以下

  .setFullScreenIntent(pendingIntent,true)
  //或者在显示对话框的时候指定,8.0+必须在NotificationChannel指定
  notificationManager.notify("",NotificationManager.IMPORTANCE_HIGH,notification)

3. 适配Android11 MediaStyle类型的Notification

Android11修改了MediaStyle类型通知栏的展示效果,如下图

可以看到,音频类型的Notification会在最上方显示,而且下拉可以展开更多选项.点击按钮也会有水波纹效果.

国内的音乐app适配Android11的特性的应用很少,QQ音乐,酷狗音乐这些大厂的应用都是没有适配的(2022-04-29)

下面说一下怎么适配Android11,实现这种效果

要实现这个效果,需要将通知的类型设置MeidaStyle样式才能实现

val style = Notification.MediaStyle()

还需要MediaSession,注意这个类在整个应用只能有一个实例,不然依赖它实现的功能的类会出现没效果的情况,比如MediaButton

val mediaSession = MediaSession(this, "komine.app.demo2")

mediaSession.setPlaybackState(
            PlaybackState.Builder()
                .setState(PlaybackState.STATE_PLAYING, 0, 1f)
                .build()
        )

        mediaSession.setMetadata(
            MediaMetadata.Builder()
                .build()
        )

将MediaSession和MediaStyle关联

style.setMediaSession(mediaSession.sessionToken)

创建一个Notification查看效果

val notification = Notification.Builder(this, channelId)
    .setSmallIcon(R.mipmap.music)
    .setStyle(style)
    .setContentTitle("棠梨煎雪")
    .setContentText("银临")
    .setLargeIcon(BitmapFactory.decodeResource(resources,R.mipmap.album))
    .build()

val notificationChannel = NotificationChannel(
    channelId,
    "音乐播放",
    NotificationManager.IMPORTANCE_DEFAULT
)

notificationManager.createNotificationChannel(notificationChannel)

notificationManager.notify(0, notification)

但是并没有播放控制按钮,接下来添加播放、上一曲、下一曲按钮

在MediaStyle类型的通知中,要显示的按钮被称为一个Action,它包含图片,文字和PendingIntent.

val mPlayAction = Notification.Action.Builder(playIcon, "文字描述(不可见)", PendingIntent.getBroadcast(mContext, NOTIFICATION_ACTION_REQUEST_CODE, Intent("你要填的Action"), PendingIntent.FLAG_UPDATE_CURRENT)).build()

调用setShowActionsInCompactView()设置要显示的Action数量,要显示多个Action时必须是连续的三个数字,不然只显示一个

style.setShowActionsInCompactView(0)

显示多个,最多三个

style.setShowActionsInCompactView(0,1,2)

然后将Action添加到Notification,调用NotificationBuilder.addAction或者setActions()

.setActions(playAction.build())

未展开时最多只能显示三个Action

要实现点击按钮播放,上一首、下一首的功能可以参考我的另一篇博客

Android蓝牙线控切歌、连接状态监听(无线耳机也适用)

完整代码

fun showNotification(view: View) {
    val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
    val style = Notification.MediaStyle()

    val mediaSession = MediaSession(this, "komine.app.demo2")

    val channelId = "komine_media_play"

    val playAction = Notification.Action.Builder(R.mipmap.play, "播放", PendingIntent.getBroadcast(this, 0, Intent("PLAY_PAUSE_ACTION"),PendingIntent.FLAG_UPDATE_CURRENT))

    val nextAction = Notification.Action.Builder(R.mipmap.next, "下一首", PendingIntent.getBroadcast(this, 0, Intent("NEXT_ACTION"), PendingIntent.FLAG_UPDATE_CURRENT))

    val prevAction = Notification.Action.Builder(R.mipmap.prev, "上一首", PendingIntent.getBroadcast(this, 0, Intent("PREV_ACTION"), PendingIntent.FLAG_UPDATE_CURRENT))

    mediaSession.setPlaybackState(
        PlaybackState.Builder()
            .setState(PlaybackState.STATE_PLAYING, 0, 1f)
            .build()
    )

    mediaSession.setMetadata(
        MediaMetadata.Builder()
            .build()
    )

    style.setShowActionsInCompactView(0,1,2)

    style.setMediaSession(mediaSession.sessionToken)

    val notification = Notification.Builder(this, channelId)
        .setSmallIcon(R.mipmap.music)
        .setStyle(style)
        .setContentTitle("棠梨煎雪")
        .setContentText("银临")
        .setLargeIcon(BitmapFactory.decodeResource(resources,R.mipmap.album))
        .setActions(playAction.build(),nextAction.build(),prevAction.build())
        .build()

    val notificationChannel = NotificationChannel(
        channelId,
        "音乐播放",
        NotificationManager.IMPORTANCE_DEFAULT
    )
    notificationManager.createNotificationChannel(notificationChannel)

    notificationManager.notify(0, notification)
}