Skip to content

Latest commit

 

History

History
105 lines (75 loc) · 6.51 KB

stacks.md

File metadata and controls

105 lines (75 loc) · 6.51 KB
Raw

以Stack的方式显示Notifications

编写:wangyachen - 原文:

当为手持式设备创建Notification时，你应该将多个相似的Notification合并成一个概括式的Notification。例如，如果你的app创建了一系列接收短信的Notification，你不应该把它们都展示出来，当多于一条短信被接收的时候，用一条Notification提示总结性信息比如"2条新消息"。

尽管如此，概括式的Notification在wear上并不是很有用处，因为用户不可能在wear上还能够阅读每条消息的详细内容(他们必须在手持式设备上打开你的app才能看到更多信息)。所以对wear而言，你应该将所有的Notification都集中起来，以stack的形式进行展示。这个stack展示的时候就像一张卡片，用户可以在上面以扩展的方式分别看到其他的Notification。通过新方法[setGroup()](http://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#setGroup(java.lang.String)能够实现该功能，同时，还能让你保持手持式设备上显示为一条概括式的Notification。

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

为了创建一个stack，可以对每个想要放入该stack的Notification调用[setGroup()](http://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#setGroup(java.lang.String)，并且指定群组的key。然后调用[notify()](http://developer.android.com/reference/java/lang/Object.html#notify()将其发送至wear上。

final static String GROUP_KEY_EMAILS = "group_key_emails";

// Build the notification, setting the group appropriately
Notification notif = new NotificationCompat.Builder(mContext)
         .setContentTitle("New mail from " + sender1)
         .setContentText(subject1)
         .setSmallIcon(R.drawable.new_mail);
         .setGroup(GROUP_KEY_EMAILS)
         .build();

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

稍后，当你创建另一个Notification的时候，指定同样的群组key。当你在调用[notify()](http://developer.android.com/reference/java/lang/Object.html#notify()的时候，这个Notification就会出现在之前那个Notification的同一个stack中，而非新建一张卡片。

Notification notif2 = new NotificationCompat.Builder(mContext)
         .setContentTitle("New mail from " + sender2)
         .setContentText(subject2)
         .setSmallIcon(R.drawable.new_mail);
         .setGroup(GROUP_KEY_EMAILS)
         .build();

notificationManager.notify(notificationId2, notif2);

在默认的情况下，Notification的排列顺序由你添加的先后顺序决定，最近的Notification会被放置在最顶端。你可以通过[setSortKey()](http://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#setSortKey(java.lang.String)来修改Notification的排顺序。

##添加概括式Notification

虽然上面介绍了最好将Notification都以stack的形式展示，但是，在手持设备上提供一个概括式的Notification还是很重要的。除了要将Notification放置在同一个stack中，还需要添加一个概括式的Notification，并对其调用[setGroupSummary()](http://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#setGroupSummary(boolean)即可实现。

该Notification并不会出现在你wear设备上的stack中，只会出现在手持式设备上。

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

// Create an InboxStyle notification
Notification summaryNotification = new NotificationCompat.Builder(mContext)
        .setContentTitle("2 new messages")
        .setSmallIcon(R.drawable.ic_small_icon)
        .setLargeIcon(largeIcon)
        .setStyle(new NotificationCompat.InboxStyle()
                .addLine("Alex Faaborg   Check this out")
                .addLine("Jeff Chang   Launch Party")
                .setBigContentTitle("2 new messages")
                .setSummaryText("johndoe@gmail.com"))
        .setGroup(GROUP_KEY_EMAILS)
        .setGroupSummary(true)
        .build();

notificationManager.notify(notificationId3, summaryNotification);

该Notification使用了NotificationCompat.InboxStyle，这个style能够让你很轻松的创建email或者短信类型的app。你可以对概括式Notification使用这个style，或者NotificationCompat中定义的其他style，或者不使用任何style也可以。

**提示:**如果想要和上面截图中一样的设计文本，请参考Styling with HTML markup和Styling with Spannables。

概括式Notification能够在不显示在wear的前提下做到影响其他的Notification。当你创建一个概括式Notification时，你可以利用NotificationCompat.WearableExtender，调用[setBackground()](http://developer.android.com/reference/android/support/v4/app/NotificationCompat.WearableExtender.html#setBackground(android.graphics.Bitmap)或者[addAction()](http://developer.android.com/reference/android/support/v4/app/NotificationCompat.WearableExtender.html#addAction(android.support.v4.app.NotificationCompat.Action)为wear上的整个stack设置一个背景图片或者一个action。以下代码展示了如何为整个stack设置背景：

Bitmap background = BitmapFactory.decodeResource(getResources(),
        R.drawable.ic_background);

NotificationCompat.WearableExtender wearableExtender =
        new NotificationCompat.WearableExtender()
        .setBackground(background);

// Create an InboxStyle notification
Notification summaryNotificationWithBackground =
        new NotificationCompat.Builder(mContext)
        .setContentTitle("2 new messages")
        ...
        .extend(wearableExtender)
        .setGroup(GROUP_KEY_EMAILS)
        .setGroupSummary(true)
        .build();

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