Notification通知全文 7.0 and 8.0通知 ,橫幅 ,顯示,抖動，響鈴
RemoteViews在更改通知(Notification)中經常會用到
RemoteViews所支援的View型別如下圖所示(注意不支援下圖中View的子類)：
RemoteViews所支援的View的型別
RemoteViews沒有提供findViewById方法，因為RemoteViews在遠端程序中顯示，因此無法直接訪問裡面的View元素，而必須通過RemoteViews所提供的一系列set方法來完成，部分set方法如下所示：
1. 簡單用法
建立通知
建立通知至少包含 小圖示、標題、內容 才能顯示
NotificationCompat.Builder builder = new NotificationCompat.Builder(this) .setSmallIcon(R.drawable.notification_icon) .setContentTitle("My notification") .setContentText("Hello World!");
傳送通知
NotificationManager manager = (NotificationManager) mContext.getSystemService(Context.NOTIFICATION_SERVICE);
manager.notify(notifyId, builder.build());
取消通知
NotificationManager manager = (NotificationManager) mContext.getSystemService(Context.NOTIFICATION_SERVICE); // 取消notifyId關聯的通知 manager.cancel(notifyId); // 取消所有通知 manager.cancelAll();
2. 基本資訊
標題/內容/小圖示
必要資訊
// 標題
builder.setContentTitle("這是通知標題");
// 內容
builder.setContentText("這是通知內容");
// 小圖示
builder.setSmallIcon(R.mipmap.ic_small_icon);
大圖示
大圖示，未設定時使用小圖示代替
// 大圖示 Bitmap bitmap = BitmapFactory.decodeResource(context.getResources(), R.mipmap.ic_large_icon); builder.setLargeIcon(bitmap);
次要內容
setContentInfo 在 api 24 被廢棄，不再顯示，用 setSubText 代替
setNumber 在 api 24 被廢棄，不再顯示
// 次要內容
builder.setSubText("這是通知的次要內容");
// 附加文字
builder.setContentInfo("INFO");
// 附加數字，等價於 setContentInfo, 為了顯示效果用一個不同的字型尺寸顯示數字
builder.setNumber(123);
時間
setShowWhen 在 api 17 被新增
setChronometerCountDown 在 api 24 新增
// 設定時間
builder.setWhen(System.currentTimeMillis())
// 設定是否顯示時間
builder.setShowWhen(false);
// 設定是否顯示時鐘表示時間(count up)
builder.setUsesChronometer(false););
// 設定時鐘是否為倒計時(count down)
builder.setChronometerCountDown(false);
進度條
當使用了 setSubText() 後，進度條將不顯示
api 24 之後，setSubText() 不再影響進度條
int max = 100; // 進度最大值
int progress = 50; // 當前進度
int indeterminate = false; // 是否是不明確的進度條
builder.setProgress(max, progress, indeterminate);
狀態列摘要(ticker)
在 api 21 後不再顯示，僅用於輔助服務。
builder.setTicker("this is ticker");
3. 標誌符(Flags)
| Flag | 描述 |
|---|---|
| Notification.FLAG_SHOW_LIGHTS | 是否使用呼吸燈提醒 |
| Notification.FLAG_INSISTENT | 持續提醒(聲音/振動)直到使用者響應(點選/取消) |
| Notification.FLAG_ONLY_ALERT_ONCE | 提醒(鈴聲/震動/滾動通知摘要)只執行一次 |
| Notification.FLAG_ONGOING_EVENT | 正在進行中通知 |
| Notification.FLAG_AUTO_CANCEL | 使用者點選通知後自動取消 |
| Notification.FLAG_NO_CLEAR | 使用者無法取消 |
| Notification.FLAG_FOREGROUND_SERVICE | 表示正在執行的服務 |
設定是否使用呼吸燈提醒(FLAG_SHOW_LIGHTS)
通過 builder.setLights 或 builder.setDefaults 設定使用呼吸燈時會自動新增 FLAG_SHOW_LIGHTS
設定提醒只執行一次(FLAG_ONLY_ALERT_ONCE)
設定提醒只執行一次
builder.setOnlyAlertOnce(true);
設定自動取消(FLAG_AUTO_CANCEL)
需要同時設定了 setContentIntent() 才有效
builder.setAutoCancel(true);
builder.setContentIntent(pendingIntent);
設定通知為進行中(FLAG_ONGOING_EVENT)
通常表示一個使用者積極參與的後臺任務，比如電話，下載，播放音樂等
使用者不能取消，效果類似FLAG_NO_CLEAR
使用者點選通知且設定了自動取消時會被刪除
builder.setOngoing(true);
設定 FLAG_INSISTENT/FLAG_NO_CLEAR
NotificationCompat.Builder 未提供設定方法，只能通過 Notification
Notification n = builder.build();
// 持續提醒直到使用者響應
n.flags |= Notification.FLAG_INSISTENT;
// 使用者無法取消
n.flags |= Notification.FLAG_NO_CLEAR;
manager.notify(notifyId, n);
4. 優先順序
| 優先順序 | 描述 |
|---|---|
| Notification.PRIORITY_MAX | 重要而緊急的通知，通知使用者這個事件是時間上緊迫的或者需要立即處理的。 |
| Notification.PRIORITY_HIGH | 高優先順序用於重要的通訊內容，例如短訊息或者聊天，這些都是對使用者來說比較有興趣的 |
| Notification.PRIORITY_DEFAULT | 預設優先順序用於沒有特殊優先順序分類的通知 |
| Notification.PRIORITY_LOW | 低優先順序可以通知使用者但又不是很緊急的事件。只顯示狀態列圖示 |
| Notification.PRIORITY_MIN | 用於後臺訊息 (例如天氣或者位置資訊)。只有使用者下拉通知抽屜才能看到內容 |
設定優先順序
builder.setPriority(Notification.PRIORITY_HIGH);
5. 提醒通知到達
提供了 鈴聲/振動/呼吸燈 三種提醒方式，可以使用一種或同時使用多種
使用預設提醒
| FLAG | 描述 |
|---|---|
| Notification.DEFAULT_SOUND | 新增預設聲音提醒 |
| Notification.DEFAULT_VIBRATE | 新增預設震動提醒 |
| Notification.DEFAULT_LIGHTS | 新增預設呼吸燈提醒 |
| Notification.DEFAULT_ALL | 同時新增以上三種預設提醒 |
// 新增預設聲音提醒
builder.setDefaults(Notification.DEFAULT_SOUND);
// 新增預設呼吸燈提醒，自動新增FLAG_SHOW_LIGHTS
builder.setDefaults(Notification.DEFAULT_LIGHTS);
新增自定義提醒
// 新增自定義聲音提醒
builder.setSound(Uri.parse("path/to/sound"));
// 新增自定義震動提醒
// 延遲200ms後震動300ms，再延遲400ms後震動500ms
long[] pattern = new long[]{200,300,400,500};
builder.setVibrate(pattern);
// 新增自定義呼吸燈提醒，自動新增FLAG_SHOW_LIGHTS
int argb = 0xffff0000; // led燈光顏色
int onMs = 300; // led亮燈持續時間
int offMs = 100; // led熄燈持續時間
builder.setLights(argb, onMs, offMs);
6. 事件
點選內容事件
int flags = PendingIntent.FLAG_UPDATE_CURRENT;
Intent intent = new Intent(this, ResultActivity.class);
PendingIntent pi = PendingIntent.getActivity(this, 0, intent, flags);
builder.setContentIntent(pi);
取消通知事件
通知被使用者取消時傳送(清除所有，右滑刪除)
“自動取消(FLAG_AUTO_CANCEL)”不會產生該事件
Intent intent = new Intent(ACTION);
intent.putExtra("op", op);
PendingIntent pi = PendingIntent.getBroadcast(this, 0, intent, 0);
builder.setDeleteIntent(pi);
全屏通知事件
響應緊急事件(比如來電)
Intent intent = new Intent(ACTION);
intent.putExtra("op", op);
PendingIntent pi = PendingIntent.getBroadcast(this, 0, intent, 0);
builder.setFullScreenIntent(pi, true);
7. 浮動通知
Android 5.0(API 21)開始支援浮動通知
裝置處於活動狀態(裝置未鎖定且其螢幕已開啟)時，可顯示浮動通知
滿足下列條件之一可觸發浮動通知：
- 使用者的 Activity 處於全屏模式中（應用使用 fullScreenIntent）
- 通知具有較高的優先順序(PRIORITY_MAX 或 PRIORITY_HIGH)並使用鈴聲或振動
注：國內各種ROM可能由於各種原因導致浮動通知不能顯示
8. 鎖定螢幕通知
Android 5.0(API 21)開始，通知可顯示在鎖定螢幕上。
可使用此功能提供媒體播放控制元件以及其他常用操作。
使用者可以通過“設定”選擇是否將通知顯示在鎖定螢幕上。
設定可見性
VISIBILITY_PUBLIC顯示通知的完整內容。VISIBILITY_SECRET不會在鎖定螢幕上顯示此通知的任何部分。VISIBILITY_PRIVATE顯示通知圖示和內容標題等基本資訊，但是隱藏通知的完整內容。
設定 VISIBILITY_PRIVATE 後，還可以通過 setPublicVersion() 提供其中隱藏了某些詳細資訊的替換版本通知內容。
9. 擴展布局
Android 4.1(API 16) 開始支援擴展布局，下拉抽屜中最頂部的一條通知的擴展布局自動展開
Android 7.0(API 24) 開始每條通知都可以單獨展開
操作按鈕
api 19 開始支援新增操作按鈕，每個展開的通知可包含最多3個操作按鈕
// 新增操作按鈕
builder.addAction(icon1, title1, pendingIntent1);
builder.addAction(icon2, title2, pendingIntent2);
樣式
使用Builder.setStyle()設定擴展布局樣式
多行文字通知
Notification notif = new Notification.Builder(mContext)
.setContentTitle("New mail from " + sender.toString())
.setContentText(subject)
.setSmallIcon(R.drawable.new_mail)
.setLargeIcon(aBitmap)
.setStyle(new Notification.BigTextStyle().bigText(aVeryLongString))
.build();
大圖通知
Notification notif = new Notification.Builder(mContext)
.setContentTitle("New photo from " + sender.toString())
.setContentText(subject)
.setSmallIcon(R.drawable.new_post)
.setLargeIcon(aBitmap)
.setStyle(new Notification.BigPictureStyle().bigPicture(aBigBitmap))
.build();
收件箱通知
最多顯示5行訊息
Notification notif = new Notification.Builder(mContext)
.setContentTitle("5 New mails from " + sender.toString())
.setContentText(subject)
.setSmallIcon(R.drawable.new_mail)
.setLargeIcon(aBitmap)
.setStyle(new Notification.InboxStyle()
.addLine(str1)
.addLine(str2)
.setContentTitle("")
.setSummaryText("+3 more"))
.build();
10. 保留 Activity 返回棧
常規 Activity
預設情況下，從通知啟動一個Activity，按返回鍵會回到主螢幕。
但某些時候有按返回鍵仍然留在當前應用的需求，這就要用到TaskStackBuilder了。
1、在manifest中定義Activity的關係
<activity
android:name=".ResultActivity"
android:parentActivityName=".MainActivity">
</activity>
2、構建帶返回棧的PendingIntent併發送通知
// 構建返回棧
TaskStackBuilder tsb = TaskStackBuilder.create(this);
tsb.addParentStack(ResultActivity.class);
tsb.addNextIntent(new Intent(this, ResultActivity.class));
// 構建包含返回棧的 PendingIntent
PendingIntent pi = tsb.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT);
// 構建通知
NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
...
builder.setContentIntent(pi);
// 傳送通知
NotificationManager manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
manager.notify(notifyId, builder.build());
特殊Activity
預設情況下，從通知啟動的Activity會在近期任務列表裡出現。
如果不需要在近期任務裡顯示，則需要做以下操作:
1、在manifest中定義Activity
<activity
android:name=".ResultActivity"
android:launchMode="singleTask"
android:taskAffinity=""
android:excludeFromRecents="true">
</activity>
2、構建PendingIntent併發送通知
// 建立 Intent
Intent intent = new Intent(this, ResultActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);
// 建立 PendingIntent
PendingIntent pi = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
// 構建通知
NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
...
builder.setContentIntent(pi);
// 傳送通知
NotificationManager manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
manager.notify(notifyId, builder.build());
Demo
https://github.com/czy1121/NotificationDemo
notify
api 19 (android 4.4)
api19_big_text
api19_big_picture
api 21 (android 5.0)
api21_big_text
api19_big_picture
api21_progress_bar
api21_heads_up
api 24 (android 7.0)
api24_basic
api24_progress_bar
api24_heads_up
如果通知不顯示步驟如下:
桌面顯示通知數量
不是所有桌面都可以的。 桌面是第三方的應用了。你的應用不能去修改它的東西。
但是miui的系統對系統有做手腳。通過反射可以設定桌面圖示訊息數量。
設定好了notification之後，在下面加下面一段程式碼就可以了。
//小米顯示桌面訊息數量
try {
Field field = notification.getClass().getDeclaredField("extraNotification");
Object extraNotification = field.get(notification);
Method method = extraNotification.getClass().getDeclaredMethod("setMessageCount", int.class);
method.invoke(extraNotification, 這裡填寫數量);
} catch (Exception e) {
e.printStackTrace();
}