Android 5.0以上heads up通知

適用Android系統：

1) Android版本>= 5.0

2) 部分ROM是不支持

 RemoteViews view=getRemoteViews(body,title, R.mipmap.ic_report_problem_red_24px, 0, date);
        if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.L){
            notification.headsUpContentView=view;
            notification.vibrate= new long[]{ 100 };
            notification.visibility =  Notification.VISIBILITY_PUBLIC;
        }
        notification.contentView = view;

 

views ： 自己賦值的RemoteViews，建議高度適用64dp，因為高度高了，有可能會出現截斷（系統做處理）。

notification.visibility =  Notification.VISIBILITY_PUBLIC (在鎖屏界面展示，具體賦值類型，請參考Notification)。

什么是通知(Notification)

通知是一個可以在應用程序正常的用戶界面之外顯示給用戶的消息。
通知發出時，它首先出現在狀態欄的通知區域中，用戶打開通知抽屜可查看通知詳情。通知區域和通知抽屜都是用戶可以隨時查看的系統控制區域。

作為安卓用戶界面的重要組成部分，通知有自己的設計指南。在Android 5.0(API level 21)中引入的 Material Design 的變化是特別重要的，更多信息請閱讀 通知設計指南。

如何創建通知

隨着Android系統不斷升級，Notification的創建方式也隨之變化，主要變化如下:

Android 3.0之前

Android 3.0 (API level 11)之前，使用new Notification()方式創建通知:

NotificationManager mNotifyMgr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
PendingIntent contentIntent = PendingIntent.getActivity(this, 0, new Intent(this, ResultActivity.class), 0);

Notification notification = new Notification(icon, tickerText, when);
notification.setLatestEventInfo(this, title, content, contentIntent);

mNotifyMgr.notify(NOTIFICATIONS_ID, notification);

 

Android 3.0 (API level 11)及更高版本

Android 3.0開始棄用new Notification()方式，改用Notification.Builder()來創建通知:

NotificationManager mNotifyMgr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
PendingIntent contentIntent = PendingIntent.getActivity(this, 0, new Intent(this, ResultActivity.class), 0);

Notification notification = new Notification.Builder(this)
            .setSmallIcon(R.drawable.notification_icon)
            .setContentTitle("My notification")
            .setContentText("Hello World!")
            .setContentIntent(contentIntent)
            .build();   // getNotification()  deprecated in API level 16

mNotifyMgr.notify(NOTIFICATIONS_ID, notification);

這里需要注意: “build()” 是Androdi 4.1(API level 16)加入的，用以替代”getNotification()”。API level 16開始棄用”getNotification()”

兼容Android 3.0之前的版本

為了兼容API level 11之前的版本，v4 Support Library中提供了NotificationCompat.Builder()這個替代方法。它與Notification.Builder()類似，二者沒有太大區別。

NotificationManager mNotifyMgr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
PendingIntent contentIntent = PendingIntent.getActivity(this, 0, new Intent(this, ResultActivity.class), 0);

NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(this)
            .setSmallIcon(R.drawable.notification_icon)
            .setContentTitle("My notification")
            .setContentText("Hello World!")
            .setContentIntent(contentIntent);

mNotifyMgr.notify(NOTIFICATIONS_ID, mBuilder.build());

 

注：除特別說明外，本文將根據 NotificationCompat.Builder() 展開解析，Notification.Builder()類似。

通知基本用法

通知的必要屬性

一個通知必須包含以下三項屬性:

• 小圖標，對應 setSmallIcon()
• 通知標題，對應 setContentTitle()
• 詳細信息，對應 setContentText()

其他屬性均為可選項，更多屬性方法請參考NotificationCompat.Builder。

盡管其他都是可選的，但一般都會為通知添加至少一個動作(Action)，這個動作可以是跳轉到Activity、啟動一個Service或發送一個Broadcas等。 通過以下方式為通知添加動作:

• 使用PendingIntent
• 通過大視圖通知的 Action Button //僅支持Android 4.1 (API level 16)及更高版本，稍后會介紹

創建通知

1、實例化一個NotificationCompat.Builder對象

NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(this)
            .setSmallIcon(R.drawable.notification_icon)
            .setContentTitle("My notification")
            .setContentText("Hello World!");

NotificationCompat.Builder自動設置的默認值:

• priority: PRIORITY_DEFAULT
• when: System.currentTimeMillis()
• audio stream: STREAM_DEFAULT

2、定義並設置一個通知動作(Action)

Intent resultIntent = new Intent(this, ResultActivity.class);
PendingIntent resultPendingIntent = PendingIntent.getActivity(
            this, 0, resultIntent, PendingIntent.FLAG_UPDATE_CURRENT);
mBuilder.setContentIntent(resultPendingIntent);

3、生成Notification對象

Notificatioin notification = mBuilder.build();

 

4、使用NotificationManager發送通知

// Sets an ID for the notification
int mNotificationId = 001;

// Gets an instance of the NotificationManager service
NotificationManager mNotifyMgr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);

// Builds the notification and issues it.
mNotifyMgr.notify(mNotificationId, notification);

 

更新通知

更新通知很簡單，只需再次發送相同ID的通知即可，如果之前的通知依然存在則會更新通知屬性，如果之前通知不存在則重新創建。
示例代碼:

NotificationManager mNotifyMgr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
// Sets an ID for the notification, so it can be updated
int notifyID = 1;
NotificationCompat.Builder mNotifyBuilder = new NotificationCompat.Builder(this)
        .setContentTitle("New Message")
        .setContentText("You've received new messages.")
        .setSmallIcon(R.drawable.ic_notify_status);

int numMessages = 0;
// Start of a loop that processes data and then notifies the user
...
    mNotifyBuilder.setContentText("new content text")
            .setNumber(++numMessages);
    // Because the ID remains unchanged, the existing notification is updated.
    mNotifyMgr.notify(notifyID, mNotifyBuilder.build());
...

取消通知

取消通知有如下4種方式:

• 點擊通知欄的清除按鈕，會清除所有可清除的通知
• 設置了 setAutoCancel() 或 FLAG_AUTO_CANCEL的通知，點擊該通知時會清除它
• 通過 NotificationManager 調用 cancel() 方法清除指定ID的通知
• 通過 NotificationManager 調用 cancelAll() 方法清除所有該應用之前發送的通知

通知類型

大視圖通知

通知有兩種視圖：普通視圖和大視圖。
普通視圖:

大視圖:

默認情況下為普通視圖，可通過NotificationCompat.Builder.setStyle()設置大視圖。

注: 大視圖(Big Views)由Android 4.1(API level 16)開始引入，且僅支持Android 4.1及更高版本。

構建大視圖通知

以上圖為例:
1、構建Action Button的PendingIntent

Intent dismissIntent = new Intent(this, PingService.class);
dismissIntent.setAction(CommonConstants.ACTION_DISMISS);
PendingIntent piDismiss = PendingIntent.getService(this, 0, dismissIntent, 0);

Intent snoozeIntent = new Intent(this, PingService.class);
snoozeIntent.setAction(CommonConstants.ACTION_SNOOZE);
PendingIntent piSnooze = PendingIntent.getService(this, 0, snoozeIntent, 0);

 

2、構建NotificatonCompat.Builder對象

NotificationCompat.Builder builder = new NotificationCompat.Builder(this)
        .setSmallIcon(R.drawable.ic_stat_notification)
        .setContentTitle(getString(R.string.notification))
        .setContentText(getString(R.string.ping))
        .setDefaults(Notification.DEFAULT_ALL) // requires VIBRATE permission
        // 該方法在Android 4.1之前會被忽略
        .setStyle(new NotificationCompat.BigTextStyle()
                .bigText(msg))
        //添加Action Button
        .addAction (R.drawable.ic_stat_dismiss,
                getString(R.string.dismiss), piDismiss)
        .addAction (R.drawable.ic_stat_snooze,
                getString(R.string.snooze), piSnooze);

3、其他步驟與普通視圖相同

進度條通知

• 明確進度的進度條
  使用setProgress(max, progress, false)來更新進度。
  max: 最大進度值
  progress: 當前進度
  false: 是否是不明確的進度條

  模擬下載過程，示例如下:

      int id = 1;
  ...
  mNotifyManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
  mBuilder = new NotificationCompat.Builder(this);
  mBuilder.setContentTitle("Picture Download")
      .setContentText("Download in progress")
      .setSmallIcon(R.drawable.ic_notification);
  
  // Start a lengthy operation in a background thread
  new Thread(
      new Runnable() {
          @Override
          public void run() {
              int incr;
              for (incr = 0; incr <= 100; incr+=5) {
                  mBuilder.setProgress(100, incr, false);
                  mNotifyManager.notify(id, mBuilder.build());
                  try {
                      // Sleep for 5 seconds
                      Thread.sleep(5*1000);
                  } catch (InterruptedException e) {
                      Log.d(TAG, "sleep failure");
                  }
              }
              mBuilder.setContentText("Download complete")//下載完成           
                      .setProgress(0,0,false);    //移除進度條
              mNotifyManager.notify(id, mBuilder.build());
          }
      }
  ).start();

   

  
  上圖，分別為下載過程中進度條通知 和 下載完成移除進度條后的通知。

• 不確定進度的進度條
  使用setProgress(0, 0, true)來表示進度不明確的進度條

  mBuilder.setProgress(0, 0, true); mNotifyManager.notify(id, mBuilder.build());
  

浮動通知(Heads-up Notifications)

Android 5.0(API level 21)開始，當屏幕未上鎖且亮屏時，通知可以以小窗口形式顯示。用戶可以在不離開當前應用前提下操作該通知。
如圖:

NotificationCompat.Builder mNotifyBuilder = new NotificationCompat.Builder(this)
        .setContentTitle("New Message")
        .setContentText("You've received new messages.")
        .setSmallIcon(R.drawable.ic_notify_status)
        .setFullScreenIntent(pendingIntent, false);

 

以下兩種情況會顯示浮動通知:

• setFullScreenIntent()，如上述示例。
• 通知擁有高優先級且使用了鈴聲和振動

鎖屏通知

Android 5.0(API level 21)開始，通知可以顯示在鎖屏上。用戶可以通過設置選擇是否允許敏感的通知內容顯示在安全的鎖屏上。
你的應用可以通過setVisibility()控制通知的顯示等級:

• VISIBILITY_PRIVATE : 顯示基本信息，如通知的圖標，但隱藏通知的全部內容
• VISIBILITY_PUBLIC : 顯示通知的全部內容
• VISIBILITY_SECRET : 不顯示任何內容，包括圖標

自定義通知

Android系統允許使用RemoteViews來自定義通知。
自定義普通視圖通知高度限制為64dp，大視圖通知高度限制為256dp。同時，建議自定義通知盡量簡單，以提高兼容性。

自定義通知需要做如下操作:
1、創建自定義通知布局
2、使用RemoteViews定義通知組件，如圖標、文字等
3、調用setContent()將RemoteViews對象綁定到NotificationCompat.Builder
4、同正常發送通知流程

注意: 避免為通知設置背景，因為兼容性原因，有些文字可能看不清。

定義通知文本樣式

通知的背景顏色在不同的設備和版本中有所不同，Android2.3開始，系統定義了一套標准通知文本樣式，建議自定義通知使用標准樣式，這樣有助於通知文本可見。
通知文本樣式:

Android 5.0之前可用:
android:style/TextAppearance.StatusBar.EventContent.Title    // 通知標題樣式  
android:style/TextAppearance.StatusBar.EventContent             // 通知內容樣式  

Android 5.0及更高版本:  
android:style/TextAppearance.Material.Notification.Title         // 通知標題樣式  
android:style/TextAppearance.Material.Notification                  // 通知內容樣式  

更多通知的標准樣式和布局，可參考源碼frameworks/base/core/res/res/layout路徑下的通知模版如:

Android 5.0之前:  
notification_template_base.xml  
notification_template_big_base.xml  
notification_template_big_picture.xml  
notification_template_big_text.xml  

Android 5.0 及更高版本:  
notification_template_material_base.xml  
notification_template_material_big_base.xml  
notification_template_material_big_picture.xml  
notification_template_part_chronometer.xml  
notification_template_progressbar.xml  

等等。

保留Activity返回棧

常規Activity

默認情況下，從通知啟動一個Activity，按返回鍵會回到主屏幕。但某些時候有按返回鍵仍然留在當前應用的需求，這就要用到TaskStackBuilder了。

1、在manifest中定義Activity的關系

Android 4.0.3 及更早版本

<activity
    android:name=".ResultActivity">
    <meta-data
        android:name="android.support.PARENT_ACTIVITY"
        android:value=".MainActivity"/>
</activity>

 

Android 4.1 及更高版本

<activity
    android:name=".ResultActivity"
    android:parentActivityName=".MainActivity">
</activity>

 

2、創建返回棧PendingIntent

Intent resultIntent = new Intent(this, ResultActivity.class);
TaskStackBuilder stackBuilder = TaskStackBuilder.create(this);
// 添加返回棧
stackBuilder.addParentStack(ResultActivity.class);
// 添加Intent到棧頂
stackBuilder.addNextIntent(resultIntent);
// 創建包含返回棧的pendingIntent
PendingIntent resultPendingIntent =
        stackBuilder.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT);

NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
builder.setContentIntent(resultPendingIntent);
NotificationManager mNotificationManager =
    (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
mNotificationManager.notify(id, builder.build());

 

上述操作后，從通知啟動ResultActivity，按返回鍵會回到MainActivity，而不是主屏幕。

特殊Activity

默認情況下，從通知啟動的Activity會在近期任務列表里出現。如果不需要在近期任務里顯示，則需要做以下操作:

1、在manifest中定義Activity

<activity
    android:name=".ResultActivity"
    android:launchMode="singleTask"
    android:taskAffinity=""
    android:excludeFromRecents="true">
</activity>

 

2、構建PendingIntent

NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
Intent notifyIntent = new Intent(this, ResultActivity.class);

// Sets the Activity to start in a new, empty task
notifyIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);

PendingIntent notifyPendingIntent =
        PendingIntent.getActivity(this, 0, notifyIntent, PendingIntent.FLAG_UPDATE_CURRENT);

builder.setContentIntent(notifyPendingIntent);
NotificationManager mNotificationManager =
    (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
mNotificationManager.notify(id, builder.build());

 

上述操作后，從通知啟動ResultActivity，此Activity不會出現在近期任務列表中。

通知常見屬性和常量

通知的提醒方式

1、聲音提醒

• 默認聲音
  notification.defaults |= Notification.DEFAULT_SOUND;

• 自定義聲音
  notification.sound = Uri.parse(“file:///sdcard0/notification.ogg”);

2、震動提醒

• 默認振動
  notification.defaults |= Notification.DEFAULT_VIBRATE;

• 自定義振動
  long[] vibrate = {100, 200, 300, 400}; //震動效果
  // 表示在100、200、300、400這些時間點交替啟動和關閉震動 notification.vibrate = vibrate;

3、閃爍提醒

• 默認閃爍
  notification.defaults |= Notification.DEFAULT_LIGHTS;

• 自定義閃爍
  notification.ledARGB = 0xff00ff00; // LED燈的顏色，綠燈
  notification.ledOnMS = 300; // LED燈顯示的毫秒數，300毫秒
  notification.ledOffMS = 1000; // LED燈關閉的毫秒數，1000毫秒
  notification.flags |= Notification.FLAG_SHOW_LIGHTS; // 必須加上這個標志

常見的Flags

• FLAG_AUTO_CANCEL
  當通知被用戶點擊之后會自動被清除(cancel)

• FLAG_INSISTENT
  在用戶響應之前會一直重復提醒音

• FLAG_ONGOING_EVENT
  表示正在運行的事件

• FLAG_NO_CLEAR
  通知欄點擊“清除”按鈕時，該通知將不會被清除

• FLAG_FOREGROUND_SERVICE
  表示當前服務是前台服務

更多Notification屬性詳見Notification。