Notification是通过建造者模式来创建。
为了兼容低版本,v4 Support Library中提供了NotificationCompat.Builder()这个替代方法。
它与原来的Notification.Builder()类似,二者没有太大区别。
通知基本用法
先来一段代码demo:
NotificationCompat.Builder builder = new NotificationCompat.Builder(context); // 旧API
Intent intent = new Intent(this, MainActivity.class); //点击之后进入MainActivity
PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
Notification notification = builder.setSmallIcon(R.mipmap.ic_launcher) //设置小图标
.setTicker("hello world") //设置文字
.setWhen(System.currentTimeMillis()) //通知的时间
.setAutoCancel(true) //点击后消失
.setContentIntent(pendingIntent) //设置意图
.build(); //创建通知对象完成
NotificationManager manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
manager.notify(1, notification); //显示通知
属性
- setSmallIcon 小图标
- setContentTitle 标题
- setContentText 详细信息
- setAutoCancel(boolean) 是否点击通知自动取消
- setOngoing(boolean) 设置是否不能消除该通知; 利用它设置他为一个正在进行的通知。他们通常是用来表示一个后台任务,用户积极参与(如播放音乐)或以某种方式正在等待,因此占用设备(如一个文件下载,同步操作,主动网络连接)
- setWhen() 时间,如果不设置,则默认显示当前的系统时间
- setContentIntent(pendingIntent) 设置意图
- setPriority(Notification.PRIORITY_DEFAULT) 设置该通知优先级
- setDefaults 向通知添加声音、闪灯和震动效果,最简单、最一致的方式是使用当前的用户默认设置,使用defaults属性
Notification.DEFAULT_VISIBLE //添加默认震动提醒 需要VIBRATE permission
Notification.DEFAULT_SOUND //添加默认声音提醒
Notification.DEFAULT_LIGHTS //添加默认三色灯提醒
Notification.DEFAULT_ALL //添加默认以上三种全部提醒
- setUsesChronometer 是否显示时间计时
- setProgress(intmax, int progress, boolean indeterminate) 设置进度, indeterminate 表示是否是不明确的进度条。可以通过setProgress(0,0,false)移除进度条
- setContentIntent(PendingIntent intent) 功能:设置点击通知栏意图。如点击跳转到一个activity
- addAction 向通知添加操作,操作通常与通知的content相连被系统作为按钮来显示。在系统的content下方显示图片与title,点击这个图片或者title就会触发设置的intent
- setLargeIcon(BitmapFactory.decodeResource(getResources(),R.drawable.wechat));
PendingIntent
- FLAG_CANCEL_CURRENT:如果要创建的PendingIntent已经存在了,那么在创建新的PendingIntent之前,原先已经存在的PendingIntent中的intent将不能使用
- FLAG_NO_CREATE:如果要创建的PendingIntent尚未存在,则不创建新的PendingIntent,直接返回null
- FLAG_ONE_SHOT:相同的PendingIntent只能使用一次,且遇到相同的PendingIntent时不会去更新PendingIntent中封装的Intent的extra部分的内容
- FLAG_UPDATE_CURRENT:如果要创建的PendingIntent已经存在了,那么在保留原先PendingIntent的同时,将原先PendingIntent封装的Intent中的extra部分替换为现在新创建的PendingIntent的intent中extra的内容
如何自定义通知的布局?
需要用到RemoteViews。我们先写好自定义通知的布局文件:
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="48dp"
android:orientation="vertical"
android:paddingEnd="48dp"
android:paddingStart="48dp">
<ImageView
android:id="@+id/icon_5"
android:layout_width="48dp"
android:layout_height="48dp"
android:layout_centerInParent="true"
android:src="@mipmap/ic_launcher_round" />
<TextView
android:id="@+id/tv_5_s"
android:layout_width="wrap_content"
android:layout_height="match_parent"
android:layout_alignParentStart="true"
android:gravity="center_vertical"
android:text="Left" />
<TextView
android:id="@+id/tv_5_e"
android:layout_width="wrap_content"
android:layout_height="match_parent"
android:layout_alignParentEnd="true"
android:gravity="center_vertical"
android:text="Right" />
</RelativeLayout>
将自定义的布局运用在通知中
NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
Intent intent = new Intent(this, MainActivity.class);
PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
RemoteViews remoteViews = new RemoteViews(getPackageName(), R.layout.layout_notificaiton);
remoteViews.setTextViewText(R.id.tv_5_s, "Start");//通过id-内容的方式设置remoteview中控件的内容,底层实现是通过Binder跨进程通信
remoteViews.setTextViewText(R.id.tv_5_e, "End");
remoteViews.setImageViewResource(R.id.icon_5, R.mipmap.ic_launcher);
remoteViews.setOnClickPendingIntent(R.id.tv_5_e, pendingIntent);
Notification notification = builder.setSmallIcon(R.mipmap.ic_launcher)//通知的构建过程基本与默认相同
.setTicker("hello world")
.setWhen(System.currentTimeMillis())
.setAutoCancel(true)
.setContent(remoteViews)//在这里设置自定义通知的内容
.build();
NotificationManager manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
manager.notify(2, notification);可以看到Remoteview更新内容的方式比较特别,因为不能通过findViewById的方式获取控件(跨进程了获取不到),所以更新实际上是通过Binder发送更新信息到remoteview来更新UI的。
Android 8.0(Api 26) 及以上如何使用?
NotificationChannel是android8.0新增的特性,如果App的targetSDKVersion>=26,没有设置channel通知渠道的话,就会导致通知无法展示。
String channelID = "1";
String channelName = "channel_name";
NotificationChannel channel = new NotificationChannel(channelID, channelName, NotificationManager.IMPORTANCE_HIGH);
NotificationManager manager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
manager.createNotificationChannel(channel);
// 利用channelName可以在系统设置页面对app某个名称的通知进行管理
NotificationCompat.Builder builder =new NotificationCompat.Builder(context, channelName);
builder.setContentText(msgDesc);
builder.setContentTitle(msgTitle);
//创建通知时指定channelID
builder.setChannelId(channelID);
Notification notification = builder.build();
注意:修改NotificationChannel 属性,升级app后该修改不生效,必须卸载app重新安装才能生效,原代码如下:
public void notifyDownloading(long progress, long num, String chName) {
Notification.Builder mBuilder = new Notification.Builder(MainActivity.this, TAG );
NotificationChannel channel = new NotificationChannel(TAG , chName, NotificationManager.IMPORTANCE_HIGH);
mNotifyManager.createNotificationChannel(channel);
mBuilder.setSmallIcon(R.drawable.notification_download_icon);
mBuilder.setProgress((int) num, (int) progress, false);
mBuilder.setContentInfo(getPercent((int) progress, (int) num));
mBuilder.setOngoing(true);
mBuilder.setWhen(System.currentTimeMillis());
mBuilder.setContentTitle(chName);
mBuilder.setContentText("download");
PendingIntent pendIntent = PendingIntent.getActivity(
MainActivity.this, NOTIFY_ID, getCurActivityIntent(), PendingIntent.FLAG_UPDATE_CURRENT);
mBuilder.setContentIntent(pendIntent);
mNotifyManager.notify(NOTIFY_ID, mBuilder.build());
}
这里将IMPORTANCE_HIGH修改为IMPORTANCE_LOW,通过Android Studio直接安装,发现修改不生效。
解决方法:修改创建Notification.Builder的id和NotificationChannel的id,修改后代码如下:
public void notifyDownloading(long progress, long num, String chName) {
Notification.Builder mBuilder = new Notification.Builder(MainActivity.this, TAG + System.currentTimeMillis());
NotificationChannel channel = new NotificationChannel(TAG + System.currentTimeMillis(), chName, NotificationManager.IMPORTANCE_LOW);
mNotifyManager.createNotificationChannel(channel);
mBuilder.setSmallIcon(R.drawable.notification_download_icon);
mBuilder.setProgress((int) num, (int) progress, false);
mBuilder.setContentInfo(getPercent((int) progress, (int) num));
mBuilder.setOngoing(true);
mBuilder.setWhen(System.currentTimeMillis());
mBuilder.setContentTitle(chName);
mBuilder.setContentText("download");
PendingIntent pendIntent = PendingIntent.getActivity(
MainActivity.this, NOTIFY_ID, getCurActivityIntent(), PendingIntent.FLAG_UPDATE_CURRENT);
mBuilder.setContentIntent(pendIntent);
mNotifyManager.notify(NOTIFY_ID, mBuilder.build());
}
通过System.currentTimeMillis()保证每次创建对象的Id不同。
参考:
https://blog.csdn.net/qq_25749749/article/details/80449108
https://www.jianshu.com/p/ca92797d925a
https://www.jianshu.com/p/33a18f224a60
https://blog.csdn.net/agaghd/article/details/79016812
https://www.jianshu.com/p/33a18f224a60
https://blog.csdn.net/agaghd/article/details/79016812