Notification(状态栏通知)知识简摘及示例

附：中文版官方详解;牛人的详解

一、什么是Notification：

通知系统使用户得知应用中重要的事情，例如有新信息到来或者日历事件提醒。将通知作为一个新的通道，提醒用户重要的事情或者记录下用户没有注意到的事情。

新变化：

在 Jelly Bean 中，通知系统做了一次被引入 Android 以来最重大的结构性和功能性升级。

• 通知可以包含操作，使用户可以在通知抽屉中直接作出回应。
• 通知在大小和布局方面更加灵活，可以展开以显示更多信息。
• 新的优先级标志让通知可以按照重要程度排序，而不仅仅只是按照时间顺序。

二、基本布局：

上面的组成元素依次是：

• Icon/Photo：大图标
• Title/Name：标题
• Message：内容信息
• Timestamp：通知时间，默认是系统发出通知的时间，也可以通过setWhen()来设置
• Secondary Icon：小图标
• 内容文字，在小图标的左手边的一个文字

所有通知的布局在基础上都包含:

• 发送通知的应用图标或者发送人的头像
• 通知标题和消息
• 时间戳
• 当主图标显示发送人头像时，在副图标位置显示应用图标

信息的基本布局在 Jelly Bean 中没有变化，所以之前的应用在 Jelly Bean 中看起来仍然是一样的。

三、Notification的基本使用流程：

状态通知栏主要涉及到2个类：Notification 和NotificationManager 
Notification：通知信息类，它里面对应了通知栏的各个属性 
NotificationManager：是状态栏通知的管理类，负责发通知、清除通知等操作。

使用的基本流程：

• Step 1. 获得NotificationManager对象： 
  NotificationManager mNManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
• Step 2. 创建一个通知栏的Builder构造类： 
  Notification.Builder mBuilder = new Notification.Builder(this);
• Step 3. 对Builder进行相关的设置，比如标题，内容，图标，动作等！
• Step 4.调用Builder的build()方法为notification赋值
• Step 5.调用NotificationManager的notify()方法发送通知！
• PS:另外我们还可以调用NotificationManager的cancel()方法取消通知

四、设置相关的一些方法：

Notification.Builder mBuilder = new Notification.Builder(this); 
后再调用下述的相关的方法进行设置：(官方API文档：Notification.Builder) 
常用的方法如下：

• 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，关于Vibrate用法后面会讲解！
• 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)并更新通知以移除指示条
• setContentIntent(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 
  使用示例：

<code class="language-Java hljs fsharp has-numbering" style="display: block; padding: 0px; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-radius: 0px; word-wrap: normal; background: transparent;"><span class="hljs-comment" style="color: rgb(136, 0, 0); box-sizing: border-box;">//点击后跳转Activity</span>
Intent intent = <span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">new</span> Intent(context,XXX.<span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">class</span>);  
PendingIntent pendingIntent = PendingIntent.getActivity(context, <span class="hljs-number" style="color: rgb(0, 102, 102); box-sizing: border-box;">0</span>, intent, <span class="hljs-number" style="color: rgb(0, 102, 102); box-sizing: border-box;">0</span>);  
mBuilder.setContentIntent(pendingIntent)  </code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right; background-color: rgb(238, 238, 238);"><li style="box-sizing: border-box; padding: 0px 5px;">1</li><li style="box-sizing: border-box; padding: 0px 5px;">2</li><li style="box-sizing: border-box; padding: 0px 5px;">3</li><li style="box-sizing: border-box; padding: 0px 5px;">4</li></ul>

• setPriority(int)：设置优先级：

优先级	用户
MAX	重要而紧急的通知，通知用户这个事件是时间上紧迫的或者需要立即处理的。
HIGH	高优先级用于重要的通信内容，例如短消息或者聊天，这些都是对用户来说比较有兴趣的。
DEFAULT	默认优先级用于没有特殊优先级分类的通知。
LOW	低优先级可以通知用户但又不是很紧急的事件。
MIN	用于后台消息 (例如天气或者位置信息)。最低优先级通知将只在状态栏显示图标，只有用户下拉通知抽屉才能看到内容。

对应属性：Notification.PRIORITY_HIGH…

五、现在就根据基本的布局来构建一个通知：

• 效果：

ps：本人用的MX4手机，界面被深度定制，所以无法显示自定义的图标，在模拟机上显示正常

• 贴代码：
  

MainActiviyty：

package com.Evan.demo_notification;

import android.app.Activity;
import android.app.Notification;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.content.Intent;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.net.Uri;
import android.os.Bundle;
import android.view.View;

public class MainActivity extends Activity implements View.OnClickListener{

	private static final int NOTIFYID_1 = 1;
	private Bitmap LargeBitmap;
	private NotificationManager  nMessage;
	private Notification notification;
	
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		nMessage=(NotificationManager) getSystemService(NOTIFICATION_SERVICE);
	}

	@Override
	public void onClick(View v) {
		switch (v.getId()) {
		case R.id.buttonOpen:
			Intent intent=new Intent(MainActivity.this,OtherActivity.class);
			PendingIntent pendingIntent=PendingIntent.getActivity(MainActivity.this, 0, intent, 0);
			//设置通知栏标题图片等属性
			Notification.Builder builder=new Notification.Builder(this);
			builder.setContentTitle("刘亦菲");//标题
			builder.setContentText("我想了很久，还是发现我们两不合适，昨晚就当什么都没发生!"
					+ "还有，你说好人");//主题内容
			builder.setTicker("刘亦菲给您发送了一条即时信息");//弹出时显示的即时提示信息
			builder.setWhen(System.currentTimeMillis());//时间
			builder.setSmallIcon(R.drawable.aa1);//小图标
			builder.setLargeIcon(BitmapFactory.decodeResource(getResources(), R.drawable.aa4));//大图标
			builder.setDefaults(Notification.DEFAULT_LIGHTS|Notification.DEFAULT_VIBRATE);//三射灯与振动器
			builder.setSound(Uri.parse("android.resource://"+getPackageName()+"/"+R.raw.aw));//提示声音
			builder.setAutoCancel(true);//设置点击后取消Notification
			builder.setContentIntent(pendingIntent);//设置pendingIntent
			notification=builder.build();
			nMessage.notify(NOTIFYID_1,notification);
			break;
		}
	}
}