Android Notification使用

有的App使用过程中会展示通知栏，比如听音乐时，打微信电话时，有快捷搜索时，都会展示出通知栏。

构建一个通知栏通常需要的几步：

1.创建通知栏管理工具：NotificationManager 对象
2.构建通知栏构造器：NotificationCompat.Builder对象
3.给构造器设置参数
4.发送请求：调用notificationManager.notify()方法

Notification常用属性解释

setContentTitle(CharSequence)：设置标题　　
setContentText(CharSequence)：设置内容
setSubText(CharSequence)：设置内容下面一小行的文字
setTicker(CharSequence)：设置收到通知时在顶部显示的文字信息
setWhen(long)：设置通知时间，一般设置的是收到通知时的System.currentTimeMillis()
setSmallIcon(int)：设置右下角的小图标，在接收到通知的时候顶部也会显示这个小图标
setLargeIcon(Bitmap)：设置左边的大图标
setAutoCancel(boolean)：用户点击Notification点击面板后是否让通知取消(默认不取消)
setDefaults(int)：向通知添加声音、闪灯和振动效果的最简单、 使用默认（defaults）属性，可以组合多个属性
Notification.DEFAULT_VIBRATE(添加默认震动提醒)
Notification.DEFAULT_SOUND(添加默认声音提醒)
Notification.DEFAULT_LIGHTS(添加默认三色灯提醒)
Notification.DEFAULT_ALL(添加默认以上3种全部提醒)
setVibrate(long[])：设置振动方式，比如：setVibrate(new long[] {0,300,500,700});延迟0ms，然后振动300ms，在延迟500ms， 接着再振动700ms
setLights(int argb, int onMs, int offMs)：设置三色灯，参数依次是：灯光颜色， 亮持续时间，暗的时间，不是所有颜色都可以，这跟设备有关，有些手机还不带三色灯； 另外，还需要为Notification设置flags为Notification.FLAG_SHOW_LIGHTS才支持三色灯提醒！
setSound(Uri)：设置接收到通知时的铃声，可以用系统的，也可以自己设置，例子如下:
.setDefaults(Notification.DEFAULT_SOUND) //获取默认铃声
.setSound(Uri.parse("file:///sdcard/xx/xx.mp3")) //获取自定义铃声
.setSound(Uri.withAppendedPath(Audio.Media.INTERNAL_CONTENT_URI, "5")) //获取Android多媒体库内的铃声
setOngoing(boolean)：设置为ture，表示它为一个正在进行的通知。他们通常是用来表示 一个后台任务,用户积极参与(如播放音乐)或以某种方式正在等待,因此占用设备(如一个文件下载, 同步操作,主动网络连接)
setProgress(int,int,boolean)：设置带进度条的通知 参数依次为：进度条最大数值，当前进度，进度是否不确定 如果为确定的进度条：调用setProgress(max, progress, false)来设置通知， 在更新进度的时候在此发起通知更新progress，并且在下载完成后要移除进度条 ，通过调用setProgress(0, 0, false)既可。如果为不确定（持续活动）的进度条， 这是在处理进度无法准确获知时显示活动正在持续，所以调用setProgress(0, 0, true) ，操作结束时，调用setProgress(0, 0, false)并更新通知以移除指示条
setContentInten(PendingIntent)：PendingIntent和Intent略有不同，它可以设置执行次数， 主要用于远程服务通信、闹铃、通知、启动器、短信中，在一般情况下用的比较少。比如这里通过 Pending启动Activity：getActivity(Context, int, Intent, int)，当然还可以启动Service或者Broadcast PendingIntent的位标识符(第四个参数)
FLAG_ONE_SHOT 表示返回的PendingIntent仅能执行一次，执行完后自动取消
FLAG_NO_CREATE 表示如果描述的PendingIntent不存在，并不创建相应的PendingIntent，而是返回NULL
FLAG_CANCEL_CURRENT 表示相应的PendingIntent已经存在，则取消前者，然后创建新的PendingIntent， 这个有利于数据保持为最新的，可以用于即时通信的通信场景
FLAG_UPDATE_CURRENT 表示更新的PendingIntent

• 发送普通通知栏

class NomalNotification(context: Context) {

    init {
        val notificationManager = context.getSystemService(NOTIFICATION_SERVICE) as NotificationManager
        val builder = NotificationCompat.Builder(context)
        //设置标题
        builder.setContentTitle("通知标题")
            //设置内容
            .setContentText("通知栏内容")
            //设置大图标
            .setLargeIcon(BitmapFactory.decodeResource(context.getResources(), R.mipmap.google))
            //设置小图标
            .setSmallIcon(R.mipmap.ic_launcher_round)
            //设置通知时间
            .setWhen(System.currentTimeMillis())
            //设置通知方式，声音，震动，呼吸灯等效果，这里通知方式为声音
            .setDefaults(Notification.DEFAULT_SOUND)

        addChannelForNotificationBuilder(notificationManager, builder, "groupId", "groupName", "channelId", "channelName")
        //发送通知请求
        notificationManager?.notify(10, builder.build())
    }

    private fun addChannelForNotificationBuilder(
        notificationManager: NotificationManager,
        build: NotificationCompat.Builder?,
        groupID: String?,
        groupName: String?,
        channelID: String,
        channelName: CharSequence?
    ) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val group = NotificationChannelGroup(groupID, groupName)
            notificationManager.createNotificationChannelGroup(group)
            val channel = NotificationChannel(channelID, channelName, NotificationManager.IMPORTANCE_DEFAULT)
            channel.group = groupID
            channel.setShowBadge(false)
            channel.enableLights(false)
            channel.setSound(null, null)
            channel.enableVibration(false)
            channel.vibrationPattern = longArrayOf(0)
            channel.lockscreenVisibility = Notification.VISIBILITY_SECRET
            notificationManager.createNotificationChannel(channel)
            build?.setChannelId(channelID)
        }
    }
}

效果如下：

• 发送自定义通知栏

class GoogleSearchNotification(context: Context) {
    //通知Id
    private val permanentNotificationId = 4
    private var notificationManager: NotificationManager
    var builder: NotificationCompat.Builder

    init {
        builder = NotificationCompat.Builder(context)
        notificationManager = context.getSystemService(AppCompatActivity.NOTIFICATION_SERVICE) as NotificationManager
        var remoteView = RemoteViews(context.packageName, R.layout.layout_google_search)
        builder?.setSmallIcon(R.mipmap.google)
        builder?.setContent(remoteView)
        addChannelForNotificationBuilder(notificationManager, builder, "searchGroup", "search", "searchid", "search")
    }

    fun showNotify() {
        notificationManager.notify(permanentNotificationId, builder?.build())
    }


    private fun addChannelForNotificationBuilder(
        notificationManager: NotificationManager,
        build: NotificationCompat.Builder?,
        groupID: String?,
        groupName: String?,
        channelID: String,
        channelName: CharSequence?
    ) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val group = NotificationChannelGroup(groupID, groupName)
            notificationManager.createNotificationChannelGroup(group)
            val channel = NotificationChannel(channelID, channelName, NotificationManager.IMPORTANCE_DEFAULT)
            channel.group = groupID
            channel.setShowBadge(false)
            channel.enableLights(false)
            channel.setSound(null, null)
            channel.enableVibration(false)
            channel.vibrationPattern = longArrayOf(0)
            channel.lockscreenVisibility = Notification.VISIBILITY_SECRET
            notificationManager.createNotificationChannel(channel)
            build?.setChannelId(channelID)
        }
    }
}

效果如下：

• 发送常驻通知栏

如上两种通知栏横滑就能被关掉，如果想创建不能被横滑关掉的通知栏，就创建一个常驻通知栏。
那么就给builder添加一句

builder.setOngoing(true)

• 通知栏设置点击事件

使用PendingIntent可以对通知栏点击事件进行跳转，PendingIntent可以看作是对Intent的一个封装，但它不是立刻执行某个行为，而是满足某些条件或触发某些事件后才执行指定的行为。
PendingIntent获取有三种方式：Activity、Service和BroadcastReceiver获取。

这里从通知栏点击跳转进入JumpActivity：

    private fun setClickSearchIntent(activity: Activity, remoteView: RemoteViews) {
        var intent = Intent(activity, JumpActivity::class.java).apply {
            flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK
        }
        val pendingIntent = PendingIntent.getActivity(activity, 0, intent, 0)
        //点击某个view根据id进行跳转
        remoteView.setOnClickPendingIntent(R.id.iv_google_search, pendingIntent)
        //builder.setContentIntent(pendingIntent)，点击整个通知栏，进行跳转
    }

遇到问题总结：

1.没有设置smallIcon
这个属性是设置显示顶部状态栏小图标的，如果不设置，则会抛出如下异常：

2.未设置NotificationChannel
在Android O及以上版本报Developer warning for package ""，Failed to post notification on channel “null”

 NotificationChannel channel = new NotificationChannel(id, name, NotificationManager
                    .IMPORTANCE_DEFAULT);
            mBuilder.setChannelId(id);
            notificationManager.createNotificationChannel(channel);

参考

Android Notification使用