Android Notification自定义通知样式你要知道的事(androi
本文将根据个人经验对做个总结,以供参考!
什么是通知()
通知是一个可以在应用程序正常的用户界面之外显示给用户的消息。
通知发出时,它首先出现在状态栏的通知区域中,用户打开通知抽屉可查看通知详情。通知区域和通知抽屉都是用户可以随时查看的系统控制区域。
作为安卓用户界面的重要组成部分,通知有自己的设计指南。在 5.0(API level 21)中引入的 的变化是特别重要的,更多信息请阅读 通知设计指南。
如何创建通知
随着系统不断升级,的创建方式也随之变化,主要变化如下:
3.0之前
3.0 (API level 11)之前,使用new ()方式创建通知:
NotificationManager mNotifyMgr =
(NotificationManager) getSystemService(NOTIFICATION_SERVICE);
PendingIntent contentIntent = PendingIntent.getActivity(
this, 0, new Intent(this, ResultActivity.class), 0);
Notification notification = new Notification(icon, tickerText, when);
notification.setLatestEventInfo(this, title, content, contentIntent);
mNotifyMgr.notify(NOTIFICATIONS_ID, notification);
3.0 (API level 11)及更高版本
3.0开始弃用new ()方式,改用.()来创建通知:
NotificationManager mNotifyMgr =
(NotificationManager) getSystemService(NOTIFICATION_SERVICE);
PendingIntent contentIntent = PendingIntent.getActivity(
this, 0, new Intent(this, ResultActivity.class), 0);
Notification notification = new Notification.Builder(this)
.setSmallIcon(R.drawable.notification_icon)
.setContentTitle("My notification")
.setContentText("Hello World!")
.setContentIntent(contentIntent)
.build();// getNotification()
mNotifyMgr.notify(NOTIFICATIONS_ID, notification);
这里需要注意: “build()” 是 4.1(API level 16)加入的,用以替代
“()”。API level 16开始弃用”()”
兼容 3.0之前的版本
为了兼容API level 11之前的版本,v4 中提供了
.()这个替代方法。它与.()类似,二者没有太大区别。
NotificationManager mNotifyMgr =
(NotificationManager) getSystemService(NOTIFICATION_SERVICE);
PendingIntent contentIntent = PendingIntent.getActivity(
this, 0, new Intent(this, ResultActivity.class), 0);
NotificationCompat.Builder mBuilder =
new NotificationCompat.Builder(this)
.setSmallIcon(R.drawable.notification_icon)
.setContentTitle("My notification")
.setContentText("Hello World!")
.setContentIntent(contentIntent);
mNotifyMgr.notify(NOTIFICATIONS_ID, mBuilder.build());
注:除特别说明外,本文将根据 .() 展开解析,
.()类似。
通知基本用法 通知的必要属性
一个通知必须包含以下三项属性:
其他属性均为可选项,更多属性方法请参考.。
尽管其他都是可选的,但一般都会为通知添加至少一个动作(),这个动作可以是跳转到、启动一个或发送一个等。 通过以下方式为通知添加动作:
创建通知
1、实例化一个.对象
NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(this) .setSmallIcon(R.drawable.notification_icon) .setContentTitle("My notification") .setContentText("Hello World!");
.自动设置的默认值:
2、定义并设置一个通知动作()
Intent resultIntent = new Intent(this, ResultActivity.class);
PendingIntent resultPendingIntent = PendingIntent.getActivity(
this, 0, resultIntent, PendingIntent.FLAG_UPDATE_CURRENT);
mBuilder.setContentIntent(resultPendingIntent);
3、生成对象
Notificatioin notification = mBuilder.build();
4、使用发送通知
// Sets an ID for the notification int mNotificationId = 001; // Gets an instance of the NotificationManager service NotificationManager mNotifyMgr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE); // Builds the notification and issues it. mNotifyMgr.notify(mNotificationId, notification);
更新通知
更新通知很简单,只需再次发送相同ID的通知即可,如果之前的通知依然存在则会更新通知属性,如果之前通知不存在则重新创建。
示例代码:
NotificationManager mNotifyMgr =
(NotificationManager) getSystemService(NOTIFICATION_SERVICE);
// Sets an ID for the notification, so it can be updated
int notifyID = 1;
NotificationCompat.Builder mNotifyBuilder =
new NotificationCompat.Builder(this)
.setContentTitle("New Message")
.setContentText("You've received new messages.")
.setSmallIcon(R.drawable.ic_notify_status);
int numMessages = 0;
...
mNotifyBuilder.setContentText("new content text")
.setNumber(++numMessages);
mNotifyMgr.notify(notifyID, mNotifyBuilder.build());
...
取消通知
取消通知有如下4种方式:
通知类型 大视图通知
通知有两种视图:普通视图和大视图。
普通视图:
大视图:
默认情况下为普通视图,可通过..()设置大视图。
注: 大视图(Big Views)由 4.1(API level 16)开始引入,且仅支持 4.1及更高版本。
构建大视图通知
以上图为例:
1、构建 的
Intent dismissIntent = new Intent(this, PingService.class);
dismissIntent.setAction(CommonConstants.ACTION_DISMISS);
PendingIntent piDismiss = PendingIntent.getService(
this, 0, dismissIntent, 0);
Intent snoozeIntent = new Intent(this, PingService.class);
snoozeIntent.setAction(CommonConstants.ACTION_SNOOZE);
PendingIntent piSnooze =
PendingIntent.getService(this, 0, snoozeIntent, 0);
2、构建.对象
NotificationCompat.Builder builder = new NotificationCompat.Builder(this) .setSmallIcon(R.drawable.ic_stat_notification) .setContentTitle(getString(R.string.notification)) .setContentText(getString(R.string.ping)) .setDefaults(Notification.DEFAULT_ALL) // 该方法在Android 4.1之前会被忽略 .setStyle(new NotificationCompat.BigTextStyle() .bigText(msg)) //添加Action Button .addAction (R.drawable.ic_stat_dismiss, getString(R.string.dismiss), piDismiss) .addAction (R.drawable.ic_stat_snooze, getString(R.string.snooze), piSnooze);
3、其他步骤与普通视图相同
进度条通知
明确进度的进度条
使用(max, , false)来更新进度。
max: 最大进度值
: 当前进度
false: 是否是不明确的进度条
模拟下载过程,示例如下:
int id = 1;
...
mNotifyManager = (NotificationManager)
getSystemService(Context.NOTIFICATION_SERVICE);
mBuilder = new NotificationCompat.Builder(this);
mBuilder.setContentTitle("Picture Download")
.setContentText("Download in progress")
.setSmallIcon(R.drawable.ic_notification);
// Start a lengthy operation in a background thread
new Thread(
new Runnable() {
@Override
public void run() {
int incr;
for (incr = 0; incr <= 100; incr+=5) {
mBuilder.setProgress(100, incr, false);
mNotifyManager.notify(id, mBuilder.build());
try {
// Sleep for 5 seconds
Thread.sleep(5*1000);
} catch (InterruptedException e) {
Log.d(TAG, "sleep failure");
}
}
mBuilder.setContentText("Download complete")//下载完成
.setProgress(0,0,false); //移除进度条
mNotifyManager.notify(id, mBuilder.build());
}
}
).start();
上图,分别为下载过程中进度条通知 和 下载完成移除进度条后的通知。
锁屏通知
5.0(API level 21)开始,通知可以显示在锁屏上。用户可以通过设置选择是否允许敏感的通知内容显示在安全的锁屏上。
你的应用可以通过()控制通知的显示等级:
自定义通知
系统允许使用来自定义通知。
自定义普通视图通知高度限制为64dp,大视图通知高度限制为256dp。同时,建议自定义通知尽量简单,以提高兼容性。
自定义通知需要做如下操作:
1、创建自定义通知布局
2、使用定义通知组件,如图标、文字等
3、调用()将对象绑定到.
4、同正常发送通知流程
注意: 避免为通知设置背景,因为兼容性原因,有些文字可能看不清。
定义通知文本样式
通知的背景颜色在不同的设备和版本中有所不同,.3开始,系统定义了一套标准通知文本样式,建议自定义通知使用标准样式,这样有助于通知文本可见。
通知文本样式:
Android 5.0之前可用:
android:style/TextAppearance.StatusBar.EventContent.Title // 通知标题样式
android:style/TextAppearance.StatusBar.EventContent // 通知内容样式
Android 5.0及更高版本:
android:style/TextAppearance.Material.Notification.Title // 通知标题样式
android:style/TextAppearance.Material.Notification // 通知内容样式
更多通知的标准样式和布局,可参考源码/base/core/res/res/路径下的通知模版如:
Android 5.0之前:
notification_template_base.xml
notification_template_big_base.xml
notification_template_big_picture.xml
notification_template_big_text.xml
Android 5.0 及更高版本:
notification_template_material_base.xml
notification_template_material_big_base.xml
notification_template_material_big_picture.xml
notification_template_part_chronometer.xml
notification_template_progressbar.xml
等等。
保留返回栈 常规
默认情况下,从通知启动一个,按返回键会回到主屏幕。但某些时候有按返回键仍然留在当前应用的需求,这就要用到了。
1、在中定义的关系
Android 4.0.3 及更早版本 <activity android:name=".ResultActivity"> <meta-data android:name="android.support.PARENT_ACTIVITY" android:value=".MainActivity"/> activity> Android 4.1 及更高版本 <activity android:name=".ResultActivity" android:parentActivityName=".MainActivity"> activity>
2、创建返回栈
Intent resultIntent = new Intent(this, ResultActivity.class);
TaskStackBuilder stackBuilder = TaskStackBuilder.create(this);
// 添加返回栈
stackBuilder.addParentStack(ResultActivity.class);
// 添加Intent到栈顶
stackBuilder.addNextIntent(resultIntent);
// 创建包含返回栈的pendingIntent
PendingIntent resultPendingIntent =
stackBuilder.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT);
NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
builder.setContentIntent(resultPendingIntent);
NotificationManager mNotificationManager =
(NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
mNotificationManager.notify(id, builder.build());
上述操作后,从通知启动,按返回键会回到,而不是主屏幕。
特殊
默认情况下,从通知启动的会在近期任务列表里出现。如果不需要在近期任务里显示,则需要做以下操作:
1、在中定义
<activity android:name=".ResultActivity" android:launchMode="singleTask" android:taskAffinity="" android:excludeFromRecents="true"> activity>
2、构建
NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
Intent notifyIntent = new Intent(this, ResultActivity.class);
// Sets the Activity to start in a new, empty task
notifyIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK
| Intent.FLAG_ACTIVITY_CLEAR_TASK);
PendingIntent notifyPendingIntent =
PendingIntent.getActivity(this, 0, notifyIntent,
PendingIntent.FLAG_UPDATE_CURRENT);
builder.setContentIntent(notifyPendingIntent);
NotificationManager mNotificationManager =
(NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
mNotificationManager.notify(id, builder.build());
上述操作后,从通知启动,此不会出现在近期任务列表中。
通知常见属性和常量 通知的提醒方式
1、声音提醒
2、震动提醒
3、闪烁提醒
常见的Flags
来一些基础知识:
基本属性
( )
设置状态栏开始动画的文字
( title)
设置内容区的标题,必须设置
( text)
设置内容区的内容,必须设置
( )
设置点击通知后操作(可以跳转,打开,或者发送广播)
(@ argb)
这个可以设置的背景色
(@ icon)
设置小图标,必须设置
( b)
设置打开通知栏后的大图标
(long when)
设置显示通知的时间,不设置默认获取系统时间,这个值会在上面显示出来
( )
设置为true,点击该条通知会自动删除,false时只能通过滑动来删除
(int pri)
设置优先级,级别高的排在前面
(int )
设置上述铃声,振动,闪烁用|分隔,常量在里
( )
设置是否为一个正在进行中的通知,这一类型的通知将无法删除
通知的提醒方式
声音提醒
默认声音
.|=.;
自定义声音
.sound=Uri.parse("file:////.ogg");
震动提醒
默认振动
.|=.;
自定义振动
long[] ={100,200,300,400};//震动效果,表示在100、200、300、400这些时间点交替启动和关闭震动
.= ;
闪烁提醒
默认闪烁
.|=.;
自定义闪烁
.=;// LED灯的颜色,绿灯
.=300;// LED灯显示的毫秒数,300毫秒
.=1000;// LED灯关闭的毫秒数,1000毫秒
.flags|=.;// 必须加上这个标志
=.(.this,(int).(),(.this,.class),.);
flags有四种不同的值:
:如果构建的已经存在,则取消前一个,重新构建一个。
:如果前一个已经不存在了,将不再构建它。
:表明这里构建的只能使用一次。
:如果构建的已经存在,那么系统将不会重复创建,只是把之前不同的传值替换掉。通常做法就是在构建的时候传入不一样的来更新
最简单的通知
将之前提到的那些基础点串起来,就可以发送一条一行文本的通知了
————————————————————————————————————————————————————————————–
现在来进行实际操作
通知有两种,默认通知与自定义通知。默认通知简单调用系统接口就能实现,如下:
发送默认通知
默认通知效果
自定义通知就稍微麻烦一些,需要定义一个文件,使用加载它并设置一些点击事件,再设置到,如下:
自定义通知代码
自定义通知效果
这个通知很简单,就是两行文本加上一个按钮,按钮具有单独的点击事件,点击后跳转到。
注意:对于自定义通知和默认通知都是必须的,否则通知显示不出来。道理很简单,需要在状态栏上显示,不设置怎么行。在5.0及以上,必须符合 风格,即白色内容,透明背景。不然系统会使用默认的图片替换。具体可参考通知栏微技巧,那些你所没关注过的小细节 标签: 通知通知栏微技巧。后面我会有一篇更详细的文章来介绍这个。对于2.3及以下的系统是必须的,否则发送通知时会抛异常。道理也很简单, 2.3及以下系统不支持给自定义通知上的元素绑定单独的点击事件,因此必须设置整个通知的点击事件。
为什么要进行样式适配?
默认通知不存在样式适配的问题,因为默认通知的布局、颜色、背景什么的都是系统的,系统总会正确的显示默认通知。但自定义通知就不一样了,自定义通知的布局完全由我们自己掌控,我们可以为元素设置任何背景、颜色。那么,问题来了。通知栏的背景各种各样,不同的ROM有不同的背景,白色、黑色、透明等。不同的版本通知栏背景也不一样,一旦我们为自定义通知上的元素设置了特定背景或颜色,就肯定会带来兼容性问题(主要是文本啦)。这样的应用一大把,贴个图大家就明白了:
未适配的自定义通知
怎么适配?
适配的方式大概有两种,一种简单粗暴:为自定义通知设置固定的背景(上图中的360卫士就这么干的),比如黑色。那么内容自然就是白色或近似白色。这样,在所有的手机上都能正常显示,不会出现在黑色背景通知栏上显示良好,到了白色背景通知栏上就几乎啥也看不见。使用这种方案的应用太多了。我个人很不推崇这种方式,这样会使得自定义通知在将近一半的手机上显示得很突兀,和系统的通知栏不够沉浸,影响整体美观。另一种方案就稍微合理一些:通过读取系统的通知栏样式文件,获取到title和的颜色,进而将这个颜色设置到自定义通知上。读取通知栏样式文件本身有兼容性问题,不同版本的样式文件有变,具体可参考这篇博客通知栏设置系统字体颜色
,这种方式也不是在所有手机上生效,实际测试发现,还是有小部分机型没法读取或是读取到的是错误的。拿到title和的颜色后,还可以通过算法(后面细说)判断这个颜色是近似白色还是近似黑色,进而能判断出通知栏的背景是近似黑色还是近似白色,这样就能根据不同的通知栏背景加载不同的自定义通知布局。进而做到良好的适配。
更好的适配
现在切入主题,谈谈如何来更好的适配自定义通知。有过锁屏开发经验的人应该知道,如果你的应用有读取系统通知栏的权限,那么每当应用程序发出一个通知,你的应用都会收到对应的对象,这个时候,我们一般会执行以下操作:
获取并展示app通知
调用之后,应用程序的通知就会显示在我们的应用里。显然,上面的代码并没有对apply返回的ut做任何其他操作,但确实这个View显示出来时就是样式良好的,可见,ut本身就是带有样式的,即便是默认通知。那么方案来了!我们先构造一个默认通知:
获取通知栏title的颜色
通知并不发送出去,只是用来获取通知栏title的颜色,如果你还想获取的颜色,抱歉,不能通过查找.R.id.text来获取,这个字段是访问不到的。可通过反射获取,更好的办法是先预先设置一个,然后遍历根据内容找到对应的再获取颜色。
拿到颜色后,可根据算法判断这个颜色是近似白色还是近似黑色,我们使用黑色作为基准色,使用方差来计算这个颜色是否近似黑色:
比较两个颜色是否近似
传入Color.BLACK,color传入刚刚获取到的title的颜色,根据我实测,阈值为180.0较为合理。上述方法返回true,即表示title的颜色近似黑色,也就是说通知栏背景近似白色。
额,经验丰富的同学应该已经洞察到第二段代码存在的兼容性问题了:根据.R.id.title去找到title对应的是不靠谱的,因为有些ROM厂商会把id改掉,导致找到的title为空。
同时还有另外一个问题:使用上述方法,不能继承自(实测5.0以下机型可以,5.0及以上机型不行),大致的原因是默认通知布局文件中的(和)被替换成了,而在5.0及以上系统中,的e(int)未被标记为,导致apply时抛异常。
为了解决这两个问题,我们改进方法:
改进后的方法
在中,设置一个默认的title文本,如果根据id找不到title,则遍历根据设置的title文本找到title:
兼容厂商改id
在中,我们先构造一个默认通知,获取到默认通知的布局文件id,并将布局加载到,此时,如果根据id找不到title,显然设置默认title的办法已经失效了。如何从中找到title是个问题。我的解决办法是:反正都已经拿到了,不如就遍历它,先找到其中的所有,取字体最大的作为title(这是合理的,因为默认通知中最多也就4个,分别是title、、info、when,title肯定是字体最大,最显眼的),并返回其颜色:
兼容
实际测试
拿到了通知栏背景的颜色后,我们就可以加载不同样式的布局,达到适配的目的。代码如下:
适配代码
效果:
4.4黑色背景的通知栏