本節引言:
本節帶來的是Android中用于在狀態欄顯示通知信息的控件:Notification,相信大部分 學Android都對他都很熟悉,而網上很多關于Notification的使用教程都是基于2.x的,而 現在普遍的Android設備基本都在4.x以上,甚至是5.0以上的都有;他們各自的Notification 都是不一樣的!而本節給大家講解的是基于4.x以上的Notification,而5.0以上的Notification 我們會在進階教程的Android 5.0新特性的章節進行講解~
1.設計文檔部分解讀
1)Notification的基本布局
上面的組成元素依次是:
Icon/Photo:大圖標
Title/Name:標題
Message:內容信息
Timestamp:通知時間,默認是系統發出通知的時間,也可以通過setWhen()來設置
Secondary Icon:小圖標
內容文字,在小圖標的左手邊的一個文字
2)擴展布局
在 Jelly Bean 中你可以為通知提供更多事件的細節。你可以通過擴展布局顯示消息的前幾行或者圖片的預覽。這樣用戶可以看多更多的內容 - 有時甚至可以看到整個消息。用戶可以通過 pinch-zoom 或者雙手指滑動來打開擴展布局。Android 為單條消息提供了兩種擴展布局 (文字和圖像) 供你開發應用時使用。
關于其他一些設計的東西,就不一一提及了,有興趣的自行查看上面提供的API文檔,知道下 這個Notification在4.x以上的版本可以多種多樣就好!我們更多的時候關注的是 如何寫代碼使用這個東西,下面我們就來學習下Notification的用法!
2.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()方法取消通知
3.設置相關的一些方法:
Notification.Builder mBuilder = new Notification.Builder(this);
后再調用下述的相關的方法進行設置: 常用的方法如下:
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使用示例:
//點擊后跳轉Activity
Intent intent = new Intent(context,XXX.class);
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
mBuilder.setContentIntent(pendingIntent)
setPriority(int):設置優先級: