通知栏Notification的详细使用

转载自:http://blog.csdn.net/vipzjyno1/article/details/25248021

在android的应用层中,涉及到很多应用框架,例如:Service框架,Activity管理机制,Broadcast机制,对话框框架,标题栏框架,状态栏框架,通知机制,ActionBar框架等等。

下面就来说说经常会使用到通知机制中的通知栏框架(Notificaiton),它适用于交互事件的通知。它是位于顶层可以展开的通知列表。它会时不时的提醒你什么软件该更新了,什么人发你微信消息了等。

(网上看了下,全面介绍的文章不多,所以就萌生了写这篇的念头,随便当作回顾笔记。下面我就通过官方文档、源代码、书上的一些资料汇总下这一块的知识,并通过一个通知栏的汇总DEMO让大家更好的了解这个类的使用,内容有点多,可以根据需求看目录学习)。

Notificaiton状态通知栏:

功能作用

1.显示接收到短消息、即使消息等信息 (如QQ、微信、新浪、短信)

2.显示客户端的推送消息(如有新版本发布,广告,推荐新闻等)

3.显示正在进行的事物(例如:后台运行的程序)(如音乐播放器、版本更新时候的下载进度等)

思维导图结构

思维导图的大体结构(按照各个节点延伸拓展学习)

Notificaiton -- service   -- BroadcastReceiver  -- Intent(flag、Action等属性应用) --PendingIntent

感慨:

一个Notificaiton通知的拓展使用就要涉及与4大组建的配合,所以学好整体的知识体系。

联系:

1.由于service 是在后台运行,所以它意图做什么我们看不到,可以通过Notificaiton 来显示提醒(如音乐的后台播放)。

2.service服务和BroadcastReceiver广播相结合,在加上Notificaiton 显示(如程序的后台更新)。

3.Intent作为意图处理,和Notificaiton的点击时间紧密结合在了一起,并且与BroadcastReceiver和service的联系也紧密不可以分割。

(service 在后台之后通过BroadcastReceiver来通知Notificaiton 显示相关东西,在通过Intent完成用户的意图操作)

相关文档:Activity启动模式 及 Intent Flags 与 栈 的关联分析

对应的官方链接

设计文档 :

官方:http://developer.android.com/design/patterns/notifications.html

译文:http://adchs.github.io/patterns/notifications.html

使用教程 :http://developer.android.com/training/notify-user/index.html

开发文档 :http://developer.android.com/reference/android/app/Notification.html

大体了解

Notification支持文字内容显示、震动三色灯铃声等多种提示形式,在默认情况下,Notification仅显示消息标题消息内容送达时间这3项内容。以下就是通知的基本布局。

通知的基本布局

普通视图:

高度64dp

大试图的通知在展开前也显示为普通视图

元素:

1.标题   Title/Name

2.大图标  Icon/Photo

3.内容文字

4.内容信息MESSAGE

5.小图标 Secondary Icon

6.通知的时间 Timestamp,默认为系统发出通知的时间,也可通过setWhen()来设置

相关分析

状态通知栏主要涉及到2个类:Notification 和NotificationManager

Notification为通知信息类,它里面对应了通知栏的各个属性

NotificationManager :  是状态栏通知的管理类,负责发通知、清除通知等操作。

注意:NotificationManager 是一个系统Service,所以必须通过getSystemService(NOTIFICATION_SERVICE)方法来获取,方法如下。


NotificationManager mNotificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);


使用步骤:

流程模块:

第一步:

创建一个通知栏的Builder构造类  (Create a Notification Builder)

第二步:

定义通知栏的Action  (Define the Notification's Action)

第三步:

设置通知栏点击事件    (Set the Notification's Click Behavior)

第四步:

通知   (Issue the Notification)

代码模块:

实现系统默认的通知栏效果:

第一步:获取状态通知栏管理:


NotificationManager mNotificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);


第二步:实例化通知栏构造器NotificationCompat.Builder:


NotificationCompat.Builder mBuilder =newNotificationCompat.Builder(this);


第三步:对Builder进行配置:


mBuilder.setContentTitle("测试标题")//设置通知栏标题

        .setContentText("测试内容") //设置通知栏显示内容

        .setContentIntent(getDefalutIntent(Notification.FLAG_AUTO_CANCEL))//设置通知栏点击意图

        //  .setNumber(number) //设置通知集合的数量

       .setTicker("测试通知来啦")//通知首次出现在通知栏,带上升动画效果的

       .setWhen(System.currentTimeMillis())//通知产生的时间,会在通知信息里显示,一般是系统获取到的时间

       .setPriority(Notification.PRIORITY_DEFAULT)//设置该通知优先级

       //  .setAutoCancel(true)//设置这个标志当用户单击面板就可以让通知将自动取消

      .setOngoing(false)//ture,设置他为一个正在进行的通知。他们通常是用来表示一个后台任务,用户积极参与(如播放音乐)或以某种方式正在等待,因此占用设备(如一个文件下载,同步操作,主动网络连接)

       .setDefaults(Notification.DEFAULT_VIBRATE)//向通知添加声音、闪灯和振动效果的最简单、最一致的方式是使用当前的用户默认设置,使用defaults属性,可以组合

        //Notification.DEFAULT_ALL  Notification.DEFAULT_SOUND 添加声音 // requires VIBRATE permission

       .setSmallIcon(R.drawable.ic_launcher);//设置通知小ICON


对应的各个方法的属性(部分方法以上代码中已经作注释,就不再介绍):

(1)方法:设置提醒标志符Flags

功能:提醒标志符,向通知添加声音、闪灯和振动效果等设置达到通知提醒效果,可以组合多个属性

有2种设置方法:

1.实例化通知栏之后通过给他添加.flags属性赋值。


Notification notification = mBuilder.build();

notification.flags = Notification.FLAG_AUTO_CANCEL;


2.通过setContentIntent(PendingIntentintent)方法中的意图设置对应的flags


publicPendingIntent getDefalutIntent(intflags){

        PendingIntent pendingIntent= PendingIntent.getActivity(this,1,newIntent(), flags);

         return pendingIntent;

}


提醒标志符成员:

Notification.FLAG_SHOW_LIGHTS              //三色灯提醒,在使用三色灯提醒时候必须加该标志符

Notification.FLAG_ONGOING_EVENT          //发起正在运行事件(活动中)

Notification.FLAG_INSISTENT//让声音、振动无限循环,直到用户响应(取消或者打开)

Notification.FLAG_ONLY_ALERT_ONCE//发起Notification后,铃声和震动均只执行一次

Notification.FLAG_AUTO_CANCEL      //用户单击通知后自动消失

Notification.FLAG_NO_CLEAR          //只有全部清除时,Notification才会清除,不清楚该通知(QQ的通知无法清除,就是用的这个)

Notification.FLAG_FOREGROUND_SERVICE    //表示正在运行的服务

(2)方法:.setDefaults(int defaults)     (NotificationCompat.Builder中的方法,用于提示)

功能:向通知添加声音、闪灯和振动效果的最简单、使用默认(defaults)属性,可以组合多个属性(和方法1中提示效果一样的)

对应属性:

Notification.DEFAULT_VIBRATE    //添加默认震动提醒  需要 VIBRATE permission

Notification.DEFAULT_SOUND    // 添加默认声音提醒

Notification.DEFAULT_LIGHTS// 添加默认三色灯提醒

Notification.DEFAULT_ALL// 添加默认以上3种全部提醒

(3)方法:setVibrate(long[] pattern)

功能:设置震动方式。

使用:


.setVibrate(newlong[] {0,300,500,700});


实现效果:延迟0ms,然后振动300ms,在延迟500ms,接着在振动700ms。

以上方法的还有种写法是


mBuilder.build().vibrate =newlong[] {0,300,500,700};


以此类推,2种写法都可以。

如果希望设置默认振动方式,设置了方法(2)中默认为DEFAULT_VIBRATE 即可。

(4)方法:.setLights(intledARGB,intledOnMS,intledOffMS)

功能:android支持三色灯提醒,这个方法就是设置不同场景下的不同颜色的灯。

描述:其中ledARGB 表示灯光颜色、 ledOnMS 亮持续时间、ledOffMS 暗的时间。

注意:1)只有在设置了标志符Flags为Notification.FLAG_SHOW_LIGHTS的时候,才支持三色灯提醒。

2)这边的颜色跟设备有关,不是所有的颜色都可以,要看具体设备。

使用:


.setLights(0xff0000ff,300,0)


同理,以下方法也可以设置同样效果:


Notification notify = mBuilder.build();

notify.flags = Notification.FLAG_SHOW_LIGHTS;

notify.ledARGB =0xff0000ff;

notify.ledOnMS =300;

notify.ledOffMS =300;


如果希望使用默认的三色灯提醒,设置了方法(2)中默认为DEFAULT_LIGHTS即可。

(5)方法:.setSound(Urisound)

功能:设置默认或则自定义的铃声,来提醒。


//获取默认铃声

.setDefaults(Notification.DEFAULT_SOUND)

//获取自定义铃声

.setSound(Uri.parse("file:///sdcard/xx/xx.mp3"))

//获取Android多媒体库内的铃声

.setSound(Uri.withAppendedPath(Audio.Media.INTERNAL_CONTENT_URI,"5"))


同理相同效果的另一种设置方法这边就不讲, 和上面的都是一样的。

(6)方法:.setPriority(int pri)

功能:设置优先级

对应优先级描述如下图:


对应属性(作用看上图就可知道):

Notification.PRIORITY_DEFAULT

Notification.PRIORITY_HIGH

Notification.PRIORITY_LOW

Notification.PRIORITY_MAX

Notification.PRIORITY_MIN

(7)方法:setOngoing(boolean ongoing)

功能:设置为ture,表示它为一个正在进行的通知。他们通常是用来表示一个后台任务,用户积极参与(如播放音乐)或以某种方式正在等待,因此占用设备(如一个文件下载,同步操作,主动网络连接)

(8)方法:setProgress(int max, int progress,boolean indeterminate)

属性:max:进度条最大数值  、progress:当前进度、indeterminate:表示进度是否不确定,true为不确定,如下第3幅图所示  ,false为确定下第1幅图所示

功能:设置带进度条的通知,可以在下载中使用

效果图如下:

注意:此方法在4.0及以后版本才有用,如果为早期版本:需要自定义通知布局,其中包含ProgressBar视图

使用:如果为确定的进度条:调用setProgress(max, progress, false)来设置通知,在更新进度的时候在此发起通知更新progress,并且在下载完成后要移除进度条,通过调用setProgress(0, 0, false)既可。

如果为不确定(持续活动)的进度条,这是在处理进度无法准确获知时显示活动正在持续,所以调用setProgress(0, 0, true),操作结束时,调用setProgress(0, 0, false)并更新通知以移除指示条

第四步:设置通知栏PendingIntent(点击动作事件等都包含在这里)

在第三步中,没有提到一个方法,就是setContentIntent(PendingIntentintent)这个方法,这里拿到这里讲。

知识点

1)什么是PendingIntent

PendingIntent和Intent略有不同,它可以设置执行次数,主要用于远程服务通信、闹铃、通知、启动器、短信中,在一般情况下用的比较少。

2)PendingIntent什么用

Notification支持多种Intent来响应单击事件、消除事件、处理紧急状态的全屏事件等。

这里就用到了setContentIntent(PendingIntentintent)来处理以上这么多的事件。

3)相关属性和方法

属性:

PendingIntent的位标识符:

FLAG_ONE_SHOT   表示返回的PendingIntent仅能执行一次,执行完后自动取消

FLAG_NO_CREATE表示如果描述的PendingIntent不存在,并不创建相应的PendingIntent,而是返回NULL

FLAG_CANCEL_CURRENT表示相应的PendingIntent已经存在,则取消前者,然后创建新的PendingIntent,这个有利于数据保持为最新的,可以用于即时通信的通信场景

FLAG_UPDATE_CURRENT     表示更新的PendingIntent

方法:

可以看出,它支持多种相应方式,有Activity、Broadcast、Service,就根据你自身需求去选择。

在各种情况下情况下它还会根据各种情况出发效果:

contentIntent:在通知窗口区域,Notification被单击时的响应事件由该intent触发;

deleteIntent:当用户点击全部清除按钮时,响应该清除事件的Intent;

fullScreenIntent:响应紧急状态的全屏事件(例如来电事件),也就是说通知来的时候,跳过在通知区域点击通知这一步,直接执行fullScreenIntent代表的事件。

例如:在执行了点击通知之后要跳转到指定的XXX的Activity的时候,可以设置以下方法来相应点击事件:


Intent intent =newIntent(context,XXX.class);

PendingIntent pendingIntent = PendingIntent.getActivity(context,0, intent,0);

mBuilder.setContentIntent(pendingIntent)


例如:在执行了清空全部的通知操作时候,可以设置以下方法来相应这个事件:

采用setDeleteIntent(PendingIntentintent)方法或按照以下写法


Intent deleteIntent =newIntent();

deleteIntent.setClass(context, XXXReceiver.class);

deleteIntent.setAction(DELETE_ACTION);

notification.deleteIntent = PendingIntent.getBroadcast(context,0, deleteIntent,0);


例如:在响应紧急事件(如来电)时候,可以设置以下方法来相应这个事件:

采用setFullScreenIntent(PendingIntentintent, boolean highPriority)

第五步,最简单的一部,发送通知请求


mNotificationManager.notify(notifyId, mBuilder.build());


拓展

实现自定义的通知栏效果:

这里要用到RemoteViews这个类。实现以下2种自定义布局。

注意:

Notification的自定义布局是RemoteViews,和其他RemoteViews一样,在自定义视图布局文件中,仅支持FrameLayout、LinearLayout、RelativeLayout三种布局控件和AnalogClock、Chronometer、Button、ImageButton、ImageView、ProgressBar、TextView、ViewFlipper、ListView、GridView、StackView和AdapterViewFlipper这些显示控件,不支持这些类的子类或Android提供的其他控件。否则会引起ClassNotFoundException异常

步骤如下:

1)创建自定义视图

2)获取远程视图对象(注:Notification的contentView不能为空)

3)设置PendingIntent(来响应各种事件)

4)发起Notification

大体4步骤这里就不详细说了,下面就把DEMO中的列子拿出来说下

样式:

1.自定义带按钮通知栏(如下样式)

正在进行的

“正在进行的”通知使用户了解正在运行的后台进程。例如,音乐播放器可以显示正在播放的音乐。也可以用来显示需要长时间处理的操作,例如下载或编码视频。“正在进行的”通知不能被手动删除。

实现方法如下:


/**

* 带按钮的通知栏

*/

publicvoidshowButtonNotify(){

NotificationCompat.Builder mBuilder =newBuilder(this);

RemoteViews mRemoteViews =newRemoteViews(getPackageName(), R.layout.view_custom_button);

mRemoteViews.setImageViewResource(R.id.custom_song_icon, R.drawable.sing_icon);

//API3.0 以上的时候显示按钮,否则消失

mRemoteViews.setTextViewText(R.id.tv_custom_song_singer,"周杰伦");

mRemoteViews.setTextViewText(R.id.tv_custom_song_name,"七里香");

//如果版本号低于(3。0),那么不显示按钮

if(BaseTools.getSystemVersion() <=9){

mRemoteViews.setViewVisibility(R.id.ll_custom_button, View.GONE);

}else{

mRemoteViews.setViewVisibility(R.id.ll_custom_button, View.VISIBLE);

}

//

if(isPlay){

mRemoteViews.setImageViewResource(R.id.btn_custom_play, R.drawable.btn_pause);

}else{

mRemoteViews.setImageViewResource(R.id.btn_custom_play, R.drawable.btn_play);

}

//点击的事件处理

Intent buttonIntent =newIntent(ACTION_BUTTON);

/* 上一首按钮 */

buttonIntent.putExtra(INTENT_BUTTONID_TAG, BUTTON_PREV_ID);

//这里加了广播,所及INTENT的必须用getBroadcast方法

PendingIntent intent_prev = PendingIntent.getBroadcast(this,1, buttonIntent, PendingIntent.FLAG_UPDATE_CURRENT);

mRemoteViews.setOnClickPendingIntent(R.id.btn_custom_prev, intent_prev);

/* 播放/暂停  按钮 */

buttonIntent.putExtra(INTENT_BUTTONID_TAG, BUTTON_PALY_ID);

PendingIntent intent_paly = PendingIntent.getBroadcast(this,2, buttonIntent, PendingIntent.FLAG_UPDATE_CURRENT);

mRemoteViews.setOnClickPendingIntent(R.id.btn_custom_play, intent_paly);

/* 下一首 按钮  */

buttonIntent.putExtra(INTENT_BUTTONID_TAG, BUTTON_NEXT_ID);

PendingIntent intent_next = PendingIntent.getBroadcast(this,3, buttonIntent, PendingIntent.FLAG_UPDATE_CURRENT);

mRemoteViews.setOnClickPendingIntent(R.id.btn_custom_next, intent_next);

mBuilder.setContent(mRemoteViews)

.setContentIntent(getDefalutIntent(Notification.FLAG_ONGOING_EVENT))

.setWhen(System.currentTimeMillis())// 通知产生的时间,会在通知信息里显示

.setTicker("正在播放")

.setPriority(Notification.PRIORITY_DEFAULT)// 设置该通知优先级

.setOngoing(true)

.setSmallIcon(R.drawable.sing_icon);

Notification notify = mBuilder.build();

notify.flags = Notification.FLAG_ONGOING_EVENT;

mNotificationManager.notify(notifyId, notify);

}


注意:带按钮的布局相应点击事件在3.0以下版本没有用,所以这边作了系统版本判断,来显示消失按钮。

2.自定义不带按钮通知栏

实现方法如下:


//先设定RemoteViews

RemoteViews view_custom =newRemoteViews(getPackageName(), R.layout.view_custom);

//设置对应IMAGEVIEW的ID的资源图片

view_custom.setImageViewResource(R.id.custom_icon, R.drawable.icon);

//      view_custom.setInt(R.id.custom_icon,"setBackgroundResource",R.drawable.icon);

view_custom.setTextViewText(R.id.tv_custom_title,"今日头条");

view_custom.setTextViewText(R.id.tv_custom_content,"金州勇士官方宣布球队已经解雇了主帅马克-杰克逊,随后宣布了最后的结果。");


之后调用:


mBuilder.setContent(view_custom)


来设定自定义的这个布局。

实现:大视图风格通知(注:4.1之前的版本不支持大视图)

只在通知被展开时显示

何时展开:通知处在顶端,或者用户通过收拾展开

收件箱风格的通知:

相比普通视图,只多出:7. 详情区域

效果图如下:

详情区域根据用途可有多种风格:

1.NotificationCompat.BigPictureStyle 大图片风格:详情区域包含一个256dp高度的位图

2.NotificationCompat.BigTextStyle大文字风格:显示一个大的文字块

3.NotificationCompat.InboxStyle  收件箱风格:显示多行文字

各种风格都具有以下常规视图不具有的内容选项:

1.大标题:在展开视图时替代普通视图的标记

2.总结文字:允许你在详情区域之下增加一行内容

拿收件箱风格为例,实现代码如下:


NotificationCompat.BigPictureStyle inboxStyle =newNotificationCompat.InboxStyle();

String[] events =newString[5];

// Sets a title for the Inbox style big view

inboxStyle.setBigContentTitle("大视图内容:");

// Moves events into the big view

for(inti=0; i < events.length; i++) {

inboxStyle.addLine(events[i]);

}

mBuilder.setContentTitle("测试标题")

.setContentText("测试内容")

//              .setNumber(number)//显示数量

.setStyle(inboxStyle)//设置风格

.setTicker("测试通知来啦");


开发中碰到的问题

(注:下面所指的低版本是指2.3及2.3以下版本)

1.如何取消掉通知栏上的通知

(1)设置对应的flags,让用户点击既被消除:


notification.flags = FLAG_AUTO_CANCEL;


(2) 通过手动消除某项或则全部通知


mNotificationMgr.cancle(NOTIFICATION_ID);//消除对应ID的通知

mNotificationMgr.cancleAll();//消除创建的所有通知


2.低版本中的部分方法已经被弃用的

(1)Notification.Builder(this).getNotification()

(2)mNotification.setLatestEventInfo(this, "title", "content", null);

这些方法都已经被启用,虽然还有效果,可是不建议使用。所以开发过程中尽量使用NotificationCompat.Builder(this)的构建方法去创建一个通知类。

3.低版本中会报的错误及解决方案:

(1)错误代码:java.lang.IllegalArgumentException: contentIntent required: pkg=com.example.notifications id=100 notification=Notification(vibrate=default,sound=null,defaults=0x2,flags=0x0)

解决方案:如果在高版本不会出错,而在2.3上面报了这个错误,通过开发文档中的以下知道你可以找打:

For this reason, you should always ensure that UI controls in a notification are also available in anActivityin your app, and you should always start thatActivitywhen users click the notification. To do this, use thesetContentIntent()method.

你就应该知道,缺少了setContentIntent()这个方法,在2.3及更低的版本中,必须给它设置设置contentIntent,如果你点击没有意图,可以在赋值的的Intent中设置为new Intent()既可,切记contentIntent不能为空。

代码如下:


publicPendingIntent getDefalutIntent(intflags){

         PendingIntent pendingIntent= PendingIntent.getActivity(this,1,newIntent(), flags);

         return pendingIntent;

}


(2)错误代码:android.app.RemoteServiceException: Bad notification posted from package com.example.notifications: Couldn't expand RemoteViews for: StatusBarNotification(package=com.example.notifications id=101 tag=null notification=Notification(vibrate=null,sound=null,defaults=0x0,flags=0x2))

解决方法:

在自定义的时候,发现了这个问题,解决:每次更新时都必须把RemoteViews给new出来才行,不能利用已有的notification.contentView直接操作!

4.低版本中,自定义的通知栏中如果带有按钮,可能按钮点击事件会失灵

解决方法:看其它的应用,好像在低版本都会隐藏掉那些按钮,就是为了不影响用户体验,所以应该就这么解决,判断版本号在去决定是否现在按钮。

5.低版本中,自定义布局中的字体颜色看不清

如右图:

解决方案:

由于2.3及之前版本,背景设是白色的那我们定义字体颜色为系统预设的颜色:


?android:attr/textColorPrimary


在资源的src/values目录中的style.xml文件中设置它标题和内容的样式为:

在2.3之后的版本中(即API >=9的版本中),在资源文件下的src/values-v9目录中的style.xml文件中设置它标题和内容的样式为:

最后赋给自定义布局中的对应标题和内容对应的style即可。

对应解决网址:

1.http://stackoverflow.com/questions/6250356/how-to-use-default-notification-style

2.http://stackoverflow.com/questions/4867338/custom-notification-layouts-and-text-colors/7320604#7320604

3.http://developer.android.com/guide/topics/ui/notifiers/notifications.html#CustomExpandedView   (官方文档)

http://developer.android.com/about/versions/android-2.2-highlights.html

6.低版本中mBuilder.setProgress(100, progress, false);没用,不显示进度条

解决方法:此方法在4.0及以后版本才有用,如果为早期版本:需要自定义通知布局,其中包含ProgressBar视图

7.自定义布局的时候,不同版本方法不一样。(弄了半天,在2.3版本不显示,原来是方法不兼容)

2.3及2.3之前:

通过


Notification notify = mBuilder.build();

notify.contentView = view_custom;

mNotificationManager.notify(notifyId, notify)


方法赋予VIEW。

2.3之后:

通过Builder以下方法赋于自定义布局。

mBuilder.setContent(view_custom)

DEMO截图:

DEMO下载:下载地址

推荐阅读更多精彩内容

  • 原文出处: http://www.androidchina.net/6174.html Notification在...
    木木00阅读 7,875评论 3 30
  • 通知(Notification)这个功能对于我们来说非常的常见。打开手机的时候,各种软件的推送消息蜂拥而至,然后我...
    忆念成风阅读 1,714评论 2 10
  • 基本使用 1.获取 NotificationManager 实例2.实例化 NotificationCompat....
    不需要任何阅读 350评论 0 7
  • Notification简介 通知是在常规UI界面之外向用户展示消息的工具,当系统发出通知时,它会以图表的形式显示...
    Cris_Ma阅读 4,763评论 2 5
  • 杨戬拉过敖寸心的手掌仔细看了一遍,一抬头就对上敖寸心得意洋洋的表情:“你悟出来了?”杨戬的声音也透着惊喜,他是知道...
    轻映阅读 214评论 0 0