----------------------------------------------------------------------------------------------------------------------------------------------------------

原文作者：Google

原文地址：http://developer.android.com/wear/notifications/stacks.html

原文版权：Creative Commons 2.5 Attribution License

译文作者：Jianan - qinxiandiqi@foxmail.com

版本号信息：本文基于2014-06-24版本号翻译

译文版权：CC BY-NC-ND 4.0。同意复制转载，但必须保留译文作者署名及译文链接。不得演绎和用于商业用途

----------------------------------------------------------------------------------------------------------------------------------------------------------


前言


当在手持设备上创建通知的时候，你应该常常将一些相似的通知归并到一个单一的摘要通知中。比方。假设你的应用接收到信息后会创建通知，你不应该在手持设备上创建多条通知。当接收到多条信息的时候。你应该使用一条单一的通知并显示相似“2 new messages”这样的摘要信息。




可是。一个摘要通知在Android Wear设备上就显得没那么实用，由于用户不能够在穿戴设备上具体阅读每条信息（他们必须在手持设备上打开你的应用程序来查看很多其他的信息）。

因此，在穿戴设备上，你应该将全部通知归档到一个栈中。

包括多个通知的栈将作为一张卡片显示。用户能够展开来查看每一条通知的具体信息。

新的setGroup()方法让这一切成为可能，而且还能够同一时候在手持设备上仅仅保持提供一条摘要通知。


很多其他关于设计通知栈的内容，请參考Design Principles of Android Wear。


Add Each Notification to a Group（将每一条信息分组）


创建一个栈，你须要为每条通知调用setGroup()方法，并指定分组的key。然后调用notfiy()方法将它发送到穿戴设备上。

final static String GROUP_KEY_EMAILS = "group_key_emails";

// Build the notification and pass this builder to WearableNotifications.Builder
NotificationCompat.Builder builder = new NotificationCompat.Builder(mContext)
         .setContentTitle("New mail from " + sender1)
         .setContentText(subject1)
         .setSmallIcon(R.drawable.new_mail);

Notification notif1 = new WearableNotifications.Builder(builder)
         .setGroup(GROUP_KEY_EMAILS)
         .build();

// Issue the notification
NotificationManagerCompat notificationManager =
        NotificationManagerCompat.from(this);
notificationManager.notify(notificationId1, notif);

之后，当你创建其他通知的时候，仅仅要你指定同样的分组key。那么你调用notify()方法之后，这条通知就会跟之前的通知一样出如今同样的通知栈里面，并替代成为一张新的卡片：

builder = new NotificationCompat.Builder(mContext)
         .setContentTitle("New mail from " + sender2)
         .setContentText(subject2)
         .setSmallIcon(R.drawable.new_mail);

// Use the same group as the previous notification
Notification notif2 = new WearableNotifications.Builder(builder)
         .setGroup(GROUP_KEY_EMAILS)
         .build();

notificationManager.notify(notificationId2, notif);

默认情况。通知的显示顺序由你的加入顺序决定，近期加入的通知将会出如今最顶部。你也能够为通知在栈中指定一个序号，仅仅要你将序号作为setGroup()方法的第二个參数传递进去。


Add a Summary Notification（加入一条摘要通知）


在手持设备上保持提供一条摘要通知是相当重要的。

因此。除了将每一条通知加入到同样的栈中之外，还要加入一条摘要通知到栈中，仅仅只是要把摘要通知的序号设置为GROUP_ORDER_SUMMARY。




这条摘要通知不会出如今穿戴设备上的通知栈中。可是会作为一条通知出如今手持设备上。

Bitmap largeIcon = BitmapFactory.decodeResource(getResources(),
        R.drawable.ic_large_icon);

builder = new NotificationCompat.Builder(this)
        .setSmallIcon(R.drawable.ic_small_icon)
        .setLargeIcon(largeIcon);

// Use the same group key and pass this builder to InboxStyle notification
WearableNotifications.Builder wearableBuilder = new WearableNotifications
        .Builder(builder)
        .setGroup(GROUP_KEY_EMAILS,
                WearableNotifications.GROUP_ORDER_SUMMARY);

// Build the final notification to show on the handset
Notification summaryNotification = new NotificationCompat.InboxStyle(
        wearableBuilder.getCompatBuilder())
        .addLine("Alex Faaborg   Check this out")
        .addLine("Jeff Chang   Launch Party")
        .setBigContentTitle("2 new messages")
        .setSummaryText("johndoe@gmail.com")
        .build();

notificationManager.notify(notificationId3, summaryNotification);

这条通知使用了NotificationCompat.InboxStyle。它提供了一种为邮件或者信息类应用程序创建通知的简单方法。你能够採用这样的风格，而其他的通知使用NotificationCompat来定义。当然你也能够全然不是用这样的风格来定义摘要通知。


提示：定义相似截图中的文字风格，能够參考Styling with HTML markup和Styling with Spannables.