Android ApiDemos示例解析(26)：App->Notification->IncomingMessage

應用程式可以使用Notifications來通知使用者某個事件發生了（如收到短信）。類NotificationManager 用來處理Notification, NotificationManager可以：

• 在Status Bar上顯示一個新的圖示。
• 在Extended status bar 視窗上顯示附加資訊或是啟動一個Activity。
• 顯示背光/LED。
• 使裝置震動。
• 發出聲音等。

對于一些沒有UI的應用程式元件（如Broadcast Receiver, Services）或是非活動狀态的Activity，Notification是推薦使用的可以提醒使用者注意的方法。

Notification通常是在Status Bar上顯示圖示或是文字，此時使用者如果想了解Notification的詳細内容，可以按住Status Bar下拉顯示Expanded Status bar 視窗，在Expanded Status bar視窗顯示該Notification詳情并可以啟動對應的Activity。

IncomingMessage 示例介紹了Notification的一般用法：

1. 首先是取得NotificationManager 對象：

NotificationManager nm
= (NotificationManager)getSystemService(NOTIFICATION_SERVICE);
           

2. 然後建立Notification，建立Notification時指定顯示在Status bar的圖示，文字以及顯示Notification的時間：

Notification notif = new Notification(R.drawable.stat_sample, tickerText,
System.currentTimeMillis());
           

3. 然後定義當使用者打開Extented status windows視窗時的标題及詳情。Notification常常代表了一個請求或者需要引起注意的事件，是以可以指定一個PendingIntent來響應使用者點選這個Notification。

// The details of our fake message
CharSequence from = "Joe";
CharSequence message = "kthx. meet u for dinner. cul8r";
 
// The PendingIntent to launch our activity if the user selects this notification
PendingIntent contentIntent = PendingIntent.getActivity(this, 0,
new Intent(this, IncomingMessageView.class), 0);
// Set the info for the views that show in the notification panel.
notif.setLatestEventInfo(this, from, message, contentIntent);
// after a 100ms delay, vibrate for 250ms, pause for 100 ms and
// then vibrate for 500ms.
notif.vibrate = new long[] { 100, 250, 100, 500};
           

4. 最後是觸發這個Notification

nm.notify(R.string.imcoming_message_ticker_text, notif);
           

一般來說對應同一個事件可以使用同一個Notification來通知使用者，nm.notify的第一個參數為Notification 的ID，類型為整數。 可以使用同一個ID來表示同一個Notification，也可以使用這個ID來取消這個Notification，在IncomingMessage 中當使用者點選顯示了這個IncomingMessage詳情後，會取消這個Notification（類IncomingMessageView中）。

nm.cancel(R.string.imcoming_message_ticker_text);