将 Notification 放成一叠

编写:wangyachen - 原文: http://developer.android.com/training/wearables/notifications/stacks.html

当为手持式设备创建Notification时,开发者应该将多个相似的Notification合并成一个概括式的Notification。例如,如果app创建了一系列接收短信的Notification,开发者不应该将多于一个Notification显示到可穿戴设备上——当接收到多于一条消息的时候,用一个Notification提供一个摘要,比如”2条新消息”。

尽管如此,一个概括式的Notification在可穿戴设备上并不是很有用处,因为用户不能在可穿戴设备上阅读每条消息的详细内容(他们必须在手持式设备上打开相应的app才能看到更多信息)。所以对可穿戴设备而言,开发者应该将所有的Notification都集中起来,放成一叠。这叠Notification以一张卡片的形式显示出来,用户可以将它展开,分别看到每个Notification的详细内容。通过新方法setGroup())能够实现该功能,同时,也能保持手持式设备上显示为一条概括式的Notification。

以Stack的方式显示Notifications - 图1
以Stack的方式显示Notifications - 图2

将每个Notification添加到一个群组中

为了创建一个stack,可以对每个想要放入该stack的Notification调用setGroup()),并且指定一个group key。然后调用notify())将其发送至可穿戴设备上。

  1. final static String GROUP_KEY_EMAILS = "group_key_emails";
  2. // Build the notification, setting the group appropriately
  3. Notification notif = new NotificationCompat.Builder(mContext)
  4. .setContentTitle("New mail from " + sender1)
  5. .setContentText(subject1)
  6. .setSmallIcon(R.drawable.new_mail);
  7. .setGroup(GROUP_KEY_EMAILS)
  8. .build();
  9. // Issue the notification
  10. NotificationManagerCompat notificationManager =
  11. NotificationManagerCompat.from(this);
  12. notificationManager.notify(notificationId1, notif);

稍后,当开发者创建另一个Notification的时候,指定同样的group key。当在调用notify())的时候,这个Notification就会出现在之前那个Notification的同一个stack中,而非新建一张卡片。

  1. Notification notif2 = new NotificationCompat.Builder(mContext)
  2. .setContentTitle("New mail from " + sender2)
  3. .setContentText(subject2)
  4. .setSmallIcon(R.drawable.new_mail);
  5. .setGroup(GROUP_KEY_EMAILS)
  6. .build();
  7. notificationManager.notify(notificationId2, notif2);

在默认的情况下,Notification的排列顺序由开发者添加的先后顺序决定,最近的Notification会被放置在最顶端。你可以通过setSortKey())来修改Notification的排顺序。

添加概括式Notification

在手持设备上提供一个概括式的Notification是很重要的。因此除了要将每条单独的Notification放置在同一个stack group中,还需要添加一个概括式的Notification,并对其调用setGroupSummary())即可实现。

该Notification并不会出现在可穿戴设备上的stack中,只会出现在手持式设备上。

以Stack的方式显示Notifications - 图3

  1. Bitmap largeIcon = BitmapFactory.decodeResource(getResources(),
  2. R.drawable.ic_large_icon);
  3. // Create an InboxStyle notification
  4. Notification summaryNotification = new NotificationCompat.Builder(mContext)
  5. .setContentTitle("2 new messages")
  6. .setSmallIcon(R.drawable.ic_small_icon)
  7. .setLargeIcon(largeIcon)
  8. .setStyle(new NotificationCompat.InboxStyle()
  9. .addLine("Alex Faaborg Check this out")
  10. .addLine("Jeff Chang Launch Party")
  11. .setBigContentTitle("2 new messages")
  12. .setSummaryText("johndoe@gmail.com"))
  13. .setGroup(GROUP_KEY_EMAILS)
  14. .setGroupSummary(true)
  15. .build();
  16. notificationManager.notify(notificationId3, summaryNotification);

该Notification使用了NotificationCompat.InboxStyle,这个style能够让开发者很轻松地创建邮件或者短信app的Notifications。开发者可以对概括式Notification使用这个style,或者NotificationCompat中定义的其他style,或者不使用任何style也可以。

Tip:如果想要和上面截图中一样的设计文本,请参考Styling with HTML markupStyling with Spannables

概括式Notification能够在不显示在可穿戴设备上的前提下做到影响可穿戴设备上的Notification。当开发者创建一个概括式Notification时,可以利用NotificationCompat.WearableExtender,调用setBackground())或者addAction())为可穿戴设备上的整个stack设置一个背景图片或者一个action。以下代码展示了如何为整个stack设置背景:

  1. Bitmap background = BitmapFactory.decodeResource(getResources(),
  2. R.drawable.ic_background);
  3. NotificationCompat.WearableExtender wearableExtender =
  4. new NotificationCompat.WearableExtender()
  5. .setBackground(background);
  6. // Create an InboxStyle notification
  7. Notification summaryNotificationWithBackground =
  8. new NotificationCompat.Builder(mContext)
  9. .setContentTitle("2 new messages")
  10. ...
  11. .extend(wearableExtender)
  12. .setGroup(GROUP_KEY_EMAILS)
  13. .setGroupSummary(true)
  14. .build();

下一课:创建可穿戴的应用