Android笔记之Notification

发表于   |  阅读量 次   |   分类于 ，

Android API中的通知（Notification）随着版本升级改了好几次。手头的《第一行代码》虽然号称「基于Android 4.X」，但里面的Notification却使用了API Level 11（Android 2.3.3）就已经deprecated的setLatestEventInfo()方法。在网上搜索一番，整理如下：

API 简介

API docs

// 常用字段
contentIntent  设置PendingIntent对象，点击时发送该Intent
defaults       添加默认效果
flags          设置flag位，例如FLAG_NO_CLEAR等
icon           设置图标
sound          设置声音
tickerText     显示在状态栏中的文字
when           发送此通知的时间戳

// 效果常量
DEFAULT_ALL      使用所有默认值，比如声音，震动，闪屏等等
DEFAULT_LIGHTS   使用默认闪光提示
DEFAULT_SOUNDS   使用默认提示声音
DEFAULT_VIBRATE  使用默认手机震动

// 以上的效果常量可以叠加：
notification.defaults = DEFAULT_SOUND|DEFAULT_VIBRATE;
notification.defaults |= DEFAULT_LIGHTS;

// 最好在真机上测试，震动效果模拟器上没有。
// 加入手机震动，一定要在AndroidManifest.xml中加入权限：
<uses-permission android:name="android.permission.VIBRATE" />

// Flag
FLAG_AUTO_CANCEL   该通知能被状态栏的清除按钮给清除掉
FLAG_NO_CLEAR      该通知能被状态栏的清除按钮给清除掉
FLAG_ONGOING_EVENT 通知放置在正在运行
FLAG_INSISTENT     是否一直进行，比如音乐一直播放，知道用户响应

// NotificationManager的常用方法
public void cancelAll()     // 移除所有通知(只是针对当前Context下的Notification)
public void cancel(int id) // 移除标记为id的通知 (只是针对当前Context下的所有Notification)
public void notify(String tag ,int id, Notification notification) // 将通知加入状态栏，标签为tag，标记为id
public void notify(int id, Notification notification)  // 将通知加入状态栏，标记为id

// Notification的常用方法
// 通知提示音
Uri soundUri = Uri.fromFile(new File("/system/media/audio/ringtones/Basic_tone.ogg"));
notification.sound = soundUri;
// 通知震动，第0、2、4..表示静止时间，1、3、5...表示震动时间
long[] vibrates = {0, 1000, 1000, 1000};
notification.vibrate = vibrates;
// LED灯
notification.ledARGB = Color.GREEN;
notification.ledOnMS = 1000;
notification.ledOffMS = 1000;
notification.flags = Notification.FLAG_SHOW_LIGHTS;

各版本用法

API Level < 11 （Android 2.3.3）

1
2
3
4
5
6
7
NotificationManager notificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
Intent intent = new Intent(this,MainActivity.class);
PendingIntent contentIndent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
Notification notification = new Notification(R.drawable.ic_launcher,"",System.currentTimeMillis() );
notification.setLatestEventInfo(MainActivity.this, "您的BMI值过高", "通知监督人", contentIndent);
//加i是为了显示多条Notification
notificationManager.notify(i,notification);

API 11 <= Level < 16) （Android 4.1.2）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
NotificationManager notificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
Intent intent = new Intent(MainActivity.this,MainActivity.class);
PendingIntent contentIndent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
Notification.Builder builder = new Notification.Builder(context)
            .setAutoCancel(true)
            .setContentTitle("title")
            .setContentText("describe")
            .setContentIntent(contentIndent)
            .setSmallIcon(R.drawable.ic_launcher)
            .setWhen(System.currentTimeMillis())
            .setOngoing(true);
notification=builder.getNotification();
//加i是为了显示多条Notification
notificationManager.notify(i,notification);

API Level >= 16 （Android 4.1.2）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
//api 16
Intent intent = new Intent(this,MainActivity.class);
PendingIntent p = PendingIntent.getActivity(this, 0, intent, 0);
notification = new Notification.Builder(this)
        // .addAction(icon, "拉下后的标题", p) //在这条通知下面添加一个icon图标button，点击触发p事件，例如 phone的挂断
        .setContentTitle("拉下后的标题")
        .setContentText("第一行内容")
        // .setContent(RemoteViews)//自定义的remoteviews
        // .setFullScreenIntent(p, true)//不会再通知栏直接显示，但拉下后可以显示内容
        // .setDeleteIntent(null)// 通知消失时的动作
        // .setContentIntent(p)//点击的动作 相当于点击button
        // .setLights(Color.GREEN, 1000, 1000)// LED 灯
        // .setNumber(22)//
        // .setOngoing(true)//不能被用户x掉，会一直显示，如音乐播放等
        // .setPriority(2)//优先级
        // .setProgress(max, progress, indeterminate)//进度条
        // .setSound(uri)//声音提示
        // .setSound(sound, streamType)//科设置 streamtype
        // .setStyle(style)//style设置 http://developer.android.com/reference/android/app/Notification.Style.html
        // .setVibrate(long[])//设置震动
        .setOnlyAlertOnce(true)//一次而已
        .setSmallIcon(R.drawable.page)//落下前显示的图标
        .setSubText("第二行内容"+"\n"+"!!!!!!!!!!")
        .setContentInfo("额外的内容")//添加到了右下角
        // .setShowWhen(true)//是否允许setwhen
        .setWhen(System.currentTimeMillis()+300)//何时通知 这里延迟了300ms，前提设置了setshowwher
        .setTicker("直接在标题栏显示的通知", null)
        .setLargeIcon(
                BitmapFactory.decodeResource(getResources(),
                        R.drawable.ic_launcher))//落下后显示的图标
        .build();//生成实例 api 16后不再使用getNotification（）
// 使用
mNotificationManager.notify(R.drawable.ic_launcher, notification);

DEMO

Activity不可见时在状态栏显示通知

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
public class MainActivity extends Activity {
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        clearNotification();
    }

    @Override
    protected void onStop() {
        showNotification();
        super.onStop();
    }

    @Override
    protected void onStart() {
        clearNotification();
        super.onStart();
    }

    /**
     * 在状态栏显示通知
     */
    private void showNotification(){
        // 创建一个NotificationManager的引用
        NotificationManager notificationManager = (NotificationManager)
            this.getSystemService(android.content.Context.NOTIFICATION_SERVICE);

        // 定义Notification的各种属性
        Notification notification =new Notification(R.drawable.icon,
                "督导系统", System.currentTimeMillis());
        //FLAG_AUTO_CANCEL   该通知能被状态栏的清除按钮给清除掉
        //FLAG_NO_CLEAR      该通知不能被状态栏的清除按钮给清除掉
        //FLAG_ONGOING_EVENT 通知放置在正在运行
        //FLAG_INSISTENT     是否一直进行，比如音乐一直播放，知道用户响应
        notification.flags |= Notification.FLAG_ONGOING_EVENT; // 将此通知放到通知栏的"Ongoing"即"正在运行"组中
        notification.flags |= Notification.FLAG_NO_CLEAR; // 表明在点击了通知栏中的"清除通知"后，此通知不清除，经常与FLAG_ONGOING_EVENT一起使用
        notification.flags |= Notification.FLAG_SHOW_LIGHTS;
        //DEFAULT_ALL     使用所有默认值，比如声音，震动，闪屏等等
        //DEFAULT_LIGHTS  使用默认闪光提示
        //DEFAULT_SOUNDS  使用默认提示声音
        //DEFAULT_VIBRATE 使用默认手机震动，需加上<uses-permission android:name="android.permission.VIBRATE" />权限
        notification.defaults = Notification.DEFAULT_LIGHTS;
        //叠加效果常量
        //notification.defaults=Notification.DEFAULT_LIGHTS|Notification.DEFAULT_SOUND;
        notification.ledARGB = Color.BLUE;
        notification.ledOnMS =5000; //闪光时间，毫秒

        // 设置通知的事件消息
        CharSequence contentTitle ="督导系统标题"; // 通知栏标题
        CharSequence contentText ="督导系统内容"; // 通知栏内容
        Intent notificationIntent =new Intent(MainActivity.this, MainActivity.class); // 点击该通知后要跳转的Activity
        PendingIntent contentItent = PendingIntent.getActivity(this, 0, notificationIntent, 0);
        notification.setLatestEventInfo(this, contentTitle, contentText, contentItent);

        // 把Notification传递给NotificationManager
        notificationManager.notify(0, notification);
    }

    //删除通知
    private void clearNotification(){
        // 启动后删除之前我们定义的通知
        NotificationManager notificationManager = (NotificationManager) this
                .getSystemService(NOTIFICATION_SERVICE);
        notificationManager.cancel(0);

    }
}

参考资料

loveNight wechat
我的微信公众号，放一些有趣的内容，不定期更新。