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

原文作者: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 markupStyling with Spannables.