Android的通知(Notification)使用詳解
這篇部落格講解一下在Android中使用Notification提示訊息給使用者,Notification是一種具有全域效果的通知,程式一般通過NotificationManager服務來發送Notification。在本篇部落格中,將介紹Notification的常規使用,以及自訂方式的使用,對於每種不同的方式,都提供樣本展示效果。
Notification
Notification,俗稱通知,是一種具有全域效果的通知,它展示在螢幕的頂端,首先會表現為一個表徵圖的形式,當使用者向下滑動的時候,展示出通知具體的內容。
注意:因為一些Android版本的相容性問題,對於Notification而言,Android3.0是一個分水嶺,在其之前構建Notification推薦使用Notification.Builder構建,而在Android3.0之後,一般推薦使用NotificationCompat.Builder構建。本文的所有代碼環境均在4.3中完成,如果使用4.1一下的裝置測試,請注意相容性問題。
通知一般通過NotificationManager服務來發送一個Notification對象來完成,NotificationManager是一個重要的系統級服務,該對象位於應用程式的架構層中,應用程式可以通過它像系統發送全域的通知。這個時候需要建立一個Notification對象,用於承載通知的內容。但是一般在實際使用過程中,一般不會直接構建Notification對象,而是使用它的一個內部類NotificationCompat.Builder來執行個體化一個對象(Android3.0之下使用Notification.Builder),並設定通知的各種屬性,最後通過NotificationCompat.Builder.build()方法得到一個Notification對象。當獲得這個對象之後,可以使用NotificationManager.notify()方法發送通知。
NotificationManager類是一個通知管理器類,這個對象是由系統維護的服務,是以單例模式獲得,所以一般並不直接執行個體化這個對象。在Activity中,可以使用Activity.getSystemService(String)方法擷取NotificationManager對象,Activity.getSystemService(String)方法可以通過Android系統級服務的控制代碼,返回對應的對象。在這裡需要返回NotificationManager,所以直接傳遞Context.NOTIFICATION_SERVICE即可。
雖然通知中提供了各種屬性的設定,但是一個通知對象,有幾個屬性是必須要設定的,其他的屬性均是可選的,必須設定的屬性如下:
?小表徵圖,使用setSamllIcon()方法設定。
?標題,使用setContentTitle()方法設定。
?常值內容,使用setContentText()方法設定。
更新與移除通知
在使用NotificationManager.notify()發送通知的時候,需要傳遞一個標識符,用於唯一標識這個通知。對於有些情境,並不是無限的添加新的通知,有時候需要更新原有通知的資訊,這個時候可以重寫構建Notification,而使用與之前通知相同標識符來發送通知,這個時候舊的通知就被被新的通知所取代,起到更新通知的效果。
對於一個通知,當展示在狀態列之後,但是使用過後,如何取消呢?Android為我們提供兩種方式移除通知,一種是Notification自己維護,使用setAutoCancel()方法設定是否維護,傳遞一個boolean類型的資料。另外一種方式使用NotificationManager通知管理器對象來維護,它通過notify()發送通知的時候,指定的通知標識Id來操作通知,可以使用cancel(int)來移除一個指定的通知,也可以使用cancelAll()移除所有的通知。
使用NotificationManager移除指定通知樣本:
NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); mNotificationManager.cancel(0);
PendingIntent
對於一個通知而言,它顯示的訊息是有限的,一般僅用於提示一些概要資訊。但是一般簡短的訊息,並不能表達需要告訴使用者的全部內容,所以需要綁定一個意圖,當使用者點擊通知的時候,調用一個意圖展示出一個Activity用來顯示詳細的內容。而Notification中,並不使用常規的Intent去傳遞一個意圖,而是使用PendingIntent。
先來聊聊Intent和PendingIntent的區別,PendingIntent可以看做是對Intent的封裝,通過名稱可以看出PendingIntent用於處理即將發生的意圖,而Intent用來處理馬上發生的意圖。而對於通知來說,它是一個系統級的全域的通知,並不確定這個意圖被執行的時間。當在應用外部執行PendingIntent時,因為它儲存了觸發App的Context,使得外部App可以如果當前App一樣執行PendingIntent裡的Intent,就算執行時觸發通知的App已經不存在了,也能通過存在PendingIntent裡的Context照常執行Intent,並且還可以處理Intent所帶來的額外的資訊。
PendingIntent提供了多個靜態getXxx()方法,用於獲得適用於不同情境的PendingIntent對象。一般需要傳遞的幾個參數都很常規,只介紹一個flag參數,用於標識PendingIntent的構造選擇:
?FLAG_CANCEL_CURRENT:如果構建的PendingIntent已經存在,則取消前一個,重新構建一個。
?FLAG_NO_CREATE:如果前一個PendingIntent已經不存在了,將不再構建它。
?FLAG_ONE_SHOT:表明這裡構建的PendingIntent只能使用一次。
?FLAG_UPDATE_CURRENT:如果構建的PendingIntent已經存在,則替換它,常用。
Notification視覺風格
Notification有兩種視覺風格,一種是標準視圖(Normal view)、一種是大視圖(Big view)。標準視圖在Android中各版本是通用的,但是對於大視圖而言,僅支援Android4.1+的版本。
從官方文檔瞭解到,一個標準視圖顯示的大小要保持在64dp高,寬度為螢幕標準。標準視圖的通知主體內容有一下幾個:
通知標題。大表徵圖。通知內容。通知訊息。小表徵圖。通知的時間,一般為系統時間,也可以使用setWhen()設定。
下面通過一個樣本,模仿上面效果的通知。
btnNotification.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Bitmap btm = BitmapFactory.decodeResource(getResources(),
R.drawable.msg);
NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(
MainActivity.this).setSmallIcon(R.drawable.msg)
.setContentTitle("5 new message")
.setContentText("twain@android.com");
mBuilder.setTicker("New message");//第一次提示訊息的時候顯示在通知欄上
mBuilder.setNumber(12);
mBuilder.setLargeIcon(btm);
mBuilder.setAutoCancel(true);//自己維護通知的消失
//構建一個Intent
Intent resultIntent = new Intent(MainActivity.this,
ResultActivity.class);
//封裝一個Intent
PendingIntent resultPendingIntent = PendingIntent.getActivity(
MainActivity.this, 0, resultIntent,
PendingIntent.FLAG_UPDATE_CURRENT);
// 設定通知主題的意圖
mBuilder.setContentIntent(resultPendingIntent);
//擷取通知管理器對象
NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
mNotificationManager.notify(0, mBuilder.build());
}
});
複製代碼
顯示效果:
而對於大視圖(Big View)而言,它的細節地區只能顯示256dp高度的內容,並且只對Android4.1+之後的裝置才支援,它比標準視圖不一樣的地方,均需要使用setStyle()方法設定,它大致的效果如下:
setStyle()傳遞一個NotificationCompat.Style對象,它是一個抽象類別,Android為我們提供了三個實作類別,用於顯示不同的情境。分別是:
NotificationCompat.BigPictureStyle, 在細節部分顯示一個256dp高度的位元影像。NotificationCompat.BigTextStyle,在細節部分顯示一個大的文字區塊。NotificationCompat.InboxStyle,在細節部分顯示一段行文本。
如果僅僅顯示一個圖片,使用BigPictureStyle是最方便的;如果需要顯示一個富文本資訊,則可以使用BigTextStyle;如果僅僅用於顯示一個文本的資訊,那麼使用InboxStyle即可。後面會以一個樣本來展示InboxStyle的使用,模仿上面圖片的顯示。
實現代碼:
btnBigViewNotification.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Bitmap btm = BitmapFactory.decodeResource(getResources(), R.drawable.msg); Intent intent = new Intent(MainActivity.this, ResultActivity.class); PendingIntent pendingIntent = PendingIntent.getActivity( MainActivity.this, 0, intent, PendingIntent.FLAG_CANCEL_CURRENT); Notification noti = new NotificationCompat.Builder( MainActivity.this) .setSmallIcon(R.drawable.msg) .setLargeIcon(btm) .setNumber(13) .setContentIntent(pendingIntent) .setStyle( new NotificationCompat.InboxStyle() .addLine( "M.Twain (Google+) Haiku is more than a cert...") .addLine("M.Twain Reminder") .addLine("M.Twain Lunch?") .addLine("M.Twain Revised Specs") .addLine("M.Twain ") .addLine( "Google Play Celebrate 25 billion apps with Goo..") .addLine( "Stack Exchange StackOverflow weekly Newsl...") .setBigContentTitle("6 new message") .setSummaryText("mtwain@android.com")) .build(); NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); mNotificationManager.notify(0, noti); } });
展示效果:
進度條樣式的通知<喎?http://www.bkjia.com/kf/ware/vc/" target="_blank" class="keylink">vc3Ryb25nPjxicj4KPGJyPgqhoaGhttTT2tK7uPax6te8zajWqqOs09DKsbryz9TKvrXEz/vPorKisrvSu7aoyse+ssystcSjrLu5v8nS1MnotqjSu7j2vfi2yMz108PT2s/Uyr7Kws7xzeqzybXEvfi2yKGjPGJyPgo8YnI+CqGhoaFOb3RpZmljYXRpb24uQnVpbGRlcsDg1tDM4bmp0ru49nNldFByb2dyZXNzKGludCBtYXgsaW50IHByb2dyZXNzLGJvb2xlYW4gaW5kZXRlcm1pbmF0ZSm3vbeo08PT2sno1sO9+LbIzPWjrG1heNPD09rJ6Laovfi2yLXE1+6088r9o6xwcm9ncmVzc9PD09rJ6LaotbHHsLXEvfi2yKOsaW5kZXRlcm1pbmF0ZdPD09rKx7fxysfSu7j2yLe2qL34tsjWu7XEvfi2yMz1oaPNqLn9aW5kZXRlcm1pbmF0ZbXEyejWw6Osv8nS1Mq1z9bBvdbWsrvNrNH5yr21xL34tsjM9aOs0rvW1srH09C9+LbItcSjqGZhbHNlo6ks0rvW1srH0a27t8H3tq+1xKOoZmFsc2WjqaGjz8LD5rfWsfDTw8G9uPbKvsD90d3KvqO6PGJyPgo8YnI+CqGhoaHT0L34tsi1xL34tsjM9aOsyrXP1rT6wuujuiA8YnI+Cjxicj4KPHByZSBjbGFzcz0="brush:java;"> btnProgreNotification.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); builder = new NotificationCompat.Builder(MainActivity.this) .setSmallIcon(R.drawable.ic_launcher) .setContentTitle("Picture Download") .setContentText("Download in progress"); builder.setAutoCancel(true); //通過一個子線程,動態增加進度條刻度 new Thread(new Runnable() { @Override public void run() { int incr; for (incr = 0; incr <= 100; incr += 5) { builder.setProgress(100, incr, false); manager.notify(0, builder.build()); try { Thread.sleep(300); } catch (InterruptedException e) { Log.i(TAG, "sleep failure"); } } builder.setContentText("Download complete") .setProgress(0, 0, false); manager.notify(0, builder.build()); } }).start(); } });
顯示效果:
對於迴圈流動的進度條,下面是實現代碼:
btnProNotification.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); builder = new NotificationCompat.Builder(MainActivity.this) .setSmallIcon(R.drawable.ic_launcher) .setContentTitle("Picture Download") .setContentText("Download in progress"); builder.setProgress(0, 0, true);//設定為true,表示流動 manager.notify(0, builder.build()); //5秒之後還停止流動 new Thread(new Runnable() { @Override public void run() { try { Thread.sleep(5000); } catch (InterruptedException e) { e.printStackTrace(); } builder.setProgress(100, 100, false);//設定為true,表示刻度 manager.notify(0, builder.build()); } }).start(); } });
效果展示:
自訂通知
和Toast一樣,通知也可以使用自訂的XML來自訂樣式,但是對於通知而言,因為它的全域性,並不能簡單的通過inflate膨脹出一個View,因為可能觸發通知的時候,響應的App已經關閉,無法擷取當指定的XML布局檔案。所以需要使用單獨的一個RemoteViews類來操作。
RemoteViews,描述了一個視圖層次的結構,可以顯示在另一個進程。階層也是從布局檔案中“膨脹”出一個視圖,這個類,提供了一些基本的操作求改其膨脹的內容。
RemoteViews提供了多個建構函式,一般使用RemoteViews(String packageName,int layoutId)。第一個參數為包的名稱,第二個為layout資源的Id。當擷取到RemoteViews對象之後,可以使用它的一系列setXxx()方法通過控制項的Id設定控制項的屬性。最後使用NotificationCompat.Builder.setContent(RemoteViews)方法設定它到一個Notification中。
下面通過一個樣本展示它:
自訂的布局XML代碼:
實現代碼:
btnCustomNotification.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { RemoteViews contentViews = new RemoteViews(getPackageName(), R.layout.custom_notification); //通過控制項的Id設定屬性 contentViews .setImageViewResource(R.id.imageNo, R.drawable.btm1); contentViews.setTextViewText(R.id.titleNo, "自訂通知標題"); contentViews.setTextViewText(R.id.textNo, "自訂通知內容"); Intent intent = new Intent(MainActivity.this, ResultActivity.class); PendingIntent pendingIntent = PendingIntent.getActivity( MainActivity.this, 0, intent, PendingIntent.FLAG_CANCEL_CURRENT); NotificationCompat.Builder mBuilder = new NotificationCompat.Builder( MainActivity.this).setSmallIcon(R.drawable.ic_launcher) .setContentTitle("My notification") .setTicker("new message"); mBuilder.setAutoCancel(true); mBuilder.setContentIntent(pendingIntent); mBuilder.setContent(contentViews); mBuilder.setAutoCancel(true); NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); mNotificationManager.notify(10, mBuilder.build()); } });
效果展示:
設定提示響應
對於有些通知,需要調用一些裝置的資源,使使用者能更快的發現有新通知,一般可設定的響應有:鈴聲、閃光燈、震動。對於這三個屬性,NotificationCompat.Builder提供了三個方法設定:
setSound(Uri sound):設定一個鈴聲,用於在通知的時候響應。傳遞一個Uri的參數,格式為“file:///mnt/sdcard/Xxx.mp3”。setLights(int argb, int onMs, int offMs
):設定前置LED燈的游標閃爍頻率,持續毫秒數,停頓毫秒數。setVibrate(long[] pattern):設定震動的模式,以一個long數組儲存毫秒級間隔的震動。
大多數時候,我們並不需要設定一個特定的響應效果,只需要遵照使用者裝置上系統通知的效果即可,那麼可以使用setDefaults(int)方法設定預設響應參數,在Notification中,對它的參數使用常量定義了,我們只需使用即可:
DEFAULT_ALL:鈴聲、閃光、震動均系統預設。DEFAULT_SOUND:系統預設鈴聲。DEFAULT_VIBRATE:系統預設震動。DEFAULT_LIGHTS:系統預設閃光。
而在Android中,如果需要訪問硬體裝置的話,是需要對其進行授權的,所以需要在資訊清單檔AndroidManifest.xml中增加兩個授權,分別授予訪問震動器與閃光燈的許可權:
因為只是一個屬性的設定,並且大部分時候,使用系統設定即可,這裡就不提供程式碼範例了。
總結
通知算是Android中比較常用的一個功能,可以保持自己App的長存,在使用者沒有進入App的時候,也提供了與使用者互動的可能。