android.app.Notification
android.app.Notification.Builder
--------------------------------------------------------------------------------------------------------------------------------------
Notification,俗称通知,是一种具有全局效果的通知,它展示在屏幕的顶端,首先会表现为一个图标的形式,当用户向下滑动的时候,展示出通知具体的内容。
NotificationManager 是一个重要的系统级服务,该对象位于应用程序的框架层中,应用程序可以通过它向系统发送全局的通知,它是管理Notification的。
这个时候需要创建一个 Notification 对象,用于承载通知的内容。
但是我们一般在实际使用过程中,不会直接去构建 Notification 对象,而是使用它的一个内部类(Android 3.0分水岭):
NotificationCompat.Builder 来实例化一个对象(Android3.0之后) --- As old as API Level 4
Notification.Builder 来实例化一个对象(Android 3.0之前) --- 本人建议使用(官方建议)
并设置通知的各种属性(setXxx),如果你还在使用setLatestEventInfo(),那我建议你还是放弃它吧,AS也是不建议你这么使用的,可以看官方文档。
最后通过.build() 方法得到一个Notification对象。
当获得这个对象之后,可以使用 NotificationManager.notify() 方法发送通知。
--------------------------------------------------------------------------------------------------------------------------------------
NotificationManager 类是一个通知管理器类,这个对象是由系统维护的服务,是以单例模式获得,所以一般并不直接实例化这个对象。
在Activity中,可以使用:Activity.getSystemService(String)方法获取NotificationManager对象,Activity.getSystemService(String)方法可以通过Android系统级服务的句柄,返回对应的对象。在这里需要返回NotificationManager,所以直接传递Context.NOTIFICATION_SERVICE即可。
NotificationManager nm = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
Notice: 虽然通知中提供了各种属性的设置,但是一个通知对象,有几个属性是必须要设置的,其他的属性均是可选的,必须设置的属性如下:
~ 小图标,使用setSamllIcon()方法设置。
~ 标题,使用setContentTitle()方法设置。
~ 文本内容,使用setContentText()方法设置。
【更新与移除通知】
在使用NotificationManager.notify()发送通知的时候,需要传递一个标识符,用于唯一标识这个通知。对于有些场景,并不是无限的添加新的通知,有时候需要更新原有通知的信息,这个时候可以重写构建Notification,而使用与之前通知相同标识符来发送通知,这个时候旧的通知就被被新的通知所取代,起到更新通知的效果。
对于一个通知,当展示在状态栏之后,但是使用过后,如何取消呢?Android为我们提供两种方式移除通知:
(1)一种是Notification自己维护,使用setAutoCancel()方法设置是否维护,传递一个boolean类型的数据。如:setAutoCanel(true)
(2)一种是使用NotificationManager通知管理器对象来维护,它通过notify()发送通知的时候,指定的通知标识Id来操作通知,可以使用cancel(int)来移除一个指定的通知,也可以使用cancelAll()移除所有的通知。
【PendingIntent】
PendingIntent提供了多个静态的getXxx()方法用于获得适用于不同场景的PendingIntent对象。一般需要传递的几个参数都很常规,只介绍一个flag参数,用于标识PendingIntent的构造选择:
~ FLAG_CANCEL_CURRENT:如果构建的PendingIntent已经存在,则取消前一个,重新构建一个。
~ FLAG_NO_CREATE:如果前一个PendingIntent已经不存在了,将不再构建它。
~ FLAG_ONE_SHOT:表明这里构建的PendingIntent只能使用一次。
~ FLAG_UPDATE_CURRENT:如果构建的PendingIntent已经存在,则替换它,常用。
【高级技巧】
对于有些通知,需要调用一些设备的资源,使用户能更快的发现有新通知,一般可设定的响应有:铃声、闪光灯、震动。对于这三个属性,Notification.Builder提供了三个方法设定:
(1)setSound(Uri sound):设定一个铃声,用于在通知的时候响应。传递一个Uri的参数,格式为“file:///mnt/sdcard/Xxx.mp3”。
(2)setLights(int argb, int onMs, int offMs ):设定前置LED灯的闪烁速率,持续毫秒数,停顿毫秒数。
(3)setVibrate(long[] pattern):设定震动的模式,以一个long数组保存毫秒级间隔的震动。
大多数时候,我们并不需要设定一个特定的响应效果,只需要遵照用户设备上系统通知的效果即可,那么可以使用setDefaults(int)方法设定默认响应参数,在Notification中,对它的参数使用常量定义了,我们只需使用即可:
setDefaults(int) :
DEFAULT_ALL:铃声、闪光、震动均系统默认。
DEFAULT_SOUND:系统默认铃声。
DEFAULT_VIBRATE:系统默认震动。
DEFAULT_LIGHTS:系统默认闪光。
而在Android中,如果需要访问硬件设备的话,是需要对其进行授权的,所以需要在清单文件AndroidManifest.xml中增加两个授权,分别授予访问振动器与闪光灯的权限:
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.FLASHLIGHT" />
【Notification视觉风格】
(1)Normal view 标准视图(如下图实例)
(2)Big view 大视图(可自行查阅)
【实例】