为可穿戴设备创建Notification

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

使用 NotificationCompat.Builder 来创建可以发送给可穿戴设备的手持设备Notification。当我们使用这个类创建Notification之后，无论Notification出现在手持式设备上还是可穿戴设备上，系统都会把Notification正确地显示出来。

Note：使用 RemoteViews 的Notification会剥除自定义的 layout，并且可穿戴设备上只显示文本和图标。但是，通过创建一个运行在可穿戴设备上的应用，开发者能够使用自定义的卡片布局创建自定义Notifications。

Import必要的类

为了引入必要的包，在我们的 build.gradle 文件中加入如下内容：

compile "com.android.support:support-v4:20.0.+"

现在我们的项目能够访问关键的包，接下来从support library中引入必要的类：

import android.support.v4.app.NotificationCompat;
import android.support.v4.app.NotificationManagerCompat;
import android.support.v4.app.NotificationCompat.WearableExtender;

通过Notification Builder创建Notification

v4 support library能够让开发者使用最新的特性去创建 Notification，诸如action 按钮和大的图标，而且兼容Android1.6（API level4）及以上的版本。

为了通过support library创建一个Notification，我们需要创建一个 NotificationCompat.Builder 的实例，然后通过将该实例传给 [notify()](http://developer.android.com/reference/java/lang/Object.html#notify()) 来发出 Notification。例如：

int notificationId = 001;
// Build intent for notification content
Intent viewIntent = new Intent(this, ViewEventActivity.class);
viewIntent.putExtra(EXTRA_EVENT_ID, eventId);
PendingIntent viewPendingIntent =
        PendingIntent.getActivity(this, 0, viewIntent, 0);

NotificationCompat.Builder notificationBuilder =
        new NotificationCompat.Builder(this)
        .setSmallIcon(R.drawable.ic_event)
        .setContentTitle(eventTitle)
        .setContentText(eventLocation)
        .setContentIntent(viewPendingIntent);

// Get an instance of the NotificationManager service
NotificationManagerCompat notificationManager =
        NotificationManagerCompat.from(this);

// Build the notification and issues it with notification manager.
notificationManager.notify(notificationId, notificationBuilder.build());

当该Notification出现在手持设备上时，用户能够通过触摸Notification来触发之前通过[setContentIntent()](http://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#setContentIntent(android.app.PendingIntent)设置的[PendingIntent](http://developer.android.com/reference/android/app/PendingIntent.html)。当该Notification出现在可穿戴设备上时，用户能够通过向左滑动该Notification显示**Open**的action，点击这个action能够激活手持设备上的Intent。

添加Action按钮

除了通过 setContentIntent() 定义的主要内容action之外，我们还可以通过传递一个 PendingIntent 给 addAction() 来添加其它action。

例如，下面的代码展示了创建一个同之前相仿的Notification，只不过添加了一个在地图上查看事件位置的action。

// Build an intent for an action to view a map
Intent mapIntent = new Intent(Intent.ACTION_VIEW);
Uri geoUri = Uri.parse("geo:0,0?q=" + Uri.encode(location));
mapIntent.setData(geoUri);
PendingIntent mapPendingIntent =
        PendingIntent.getActivity(this, 0, mapIntent, 0);

NotificationCompat.Builder notificationBuilder =
        new NotificationCompat.Builder(this)
        .setSmallIcon(R.drawable.ic_event)
        .setContentTitle(eventTitle)
        .setContentText(eventLocation)
        .setContentIntent(viewPendingIntent)
        .addAction(R.drawable.ic_map,
                getString(R.string.map), mapPendingIntent);

在手持设备上，action表现为在Notification上附加的一个额外按钮。而在可穿戴设备上，action表现为Notification左滑后出现的大按钮。当用户点击action时，能够触发手持设备上对应的intent。

Tip：如果我们的Notification包含了一个"回复"的action(例如短信类app)，我们可以通过支持直接从Android可穿戴设备返回的语音输入，来加强该功能的体验。更多信息，详见在Notification中接收语音输入。

可穿戴式独有的 Actions

如果开发者想要可穿戴式设备上的action与手持式设备不一样的话，可以使用 WearableExtender.addAction()，一旦我们通过这种方式添加了action，可穿戴式设备便不会显示任何其他通过 NotificationCompat.Builder.addAction() 添加的action。这是因为，只有通过 WearableExtender.addAction() 添加的action才能只在可穿戴设备上显示且不在手持式设备上显示。

// Create an intent for the reply action
Intent actionIntent = new Intent(this, ActionActivity.class);
PendingIntent actionPendingIntent =
        PendingIntent.getActivity(this, 0, actionIntent,
                PendingIntent.FLAG_UPDATE_CURRENT);

// Create the action
NotificationCompat.Action action =
        new NotificationCompat.Action.Builder(R.drawable.ic_action,
                getString(R.string.label, actionPendingIntent))
                .build();

// Build the notification and add the action via WearableExtender
Notification notification =
        new NotificationCompat.Builder(mContext)
                .setSmallIcon(R.drawable.ic_message)
                .setContentTitle(getString(R.string.title))
                .setContentText(getString(R.string.content))
                .extend(new WearableExtender().addAction(action))
                .build();

添加一个Big View

开发者可以在Notification中通过添加某种"big view"风格来插入扩展文本。在手持式设备上，用户能够通过展开Notification看见big view的内容。在可穿戴式设备上，big view内容是默认可见的。

可以通过 NotificationCompat.Builder 对象调用 setStyle()，并设置参数为 BigTextStyle 或 InboxStyle 的实例，从而将扩展内容添加到 Notification 中。

比如，下面的代码为事件 Notification 添加了一个 NotificationCompat.BigTextStyle 的实例，目的是为了包含完整的事件描述(这能够包含比 setContentText() 提供的空间所能容纳的字数更多的文字)。

// Specify the 'big view' content to display the long
// event description that may not fit the normal content text.
BigTextStyle bigStyle = new NotificationCompat.BigTextStyle();
bigStyle.bigText(eventDescription);

NotificationCompat.Builder notificationBuilder =
        new NotificationCompat.Builder(this)
        .setSmallIcon(R.drawable.ic_event)
        .setLargeIcon(BitmapFractory.decodeResource(
                getResources(), R.drawable.notif_background))
        .setContentTitle(eventTitle)
        .setContentText(eventLocation)
        .setContentIntent(viewPendingIntent)
        .addAction(R.drawable.ic_map,
                getString(R.string.map), mapPendingIntent)
        .setStyle(bigStyle);

要注意的是，开发者可以通过 setLargeIcon() 方法为任何 Notification 添加一个大图标。但是，这些图标在可穿戴设备上会显示成大的背景图片，并且由于这些图标会被放大以适应可穿戴设备的屏幕，导致这些图标显示的效果不好。想要为 Notification 添加一个可穿戴设备适用的背景图片，请看下面一小节为 Notification 添加可穿戴式特性。更多关于大图片在 Notification 上的设计，详见 Design Principles of Android Wear。

为Notification添加可穿戴式特性

如果我们需要为 Notification 添加一些可穿戴式的特性设置，比如制定额外的内容页，或者让用户通过语音输入一些文字，那么我们可以使用 NotificationCompat.WearableExtender 来制定这些设置。为了适用这个 API，我们需要：

1. 创建一个 WearableExtender 的实例，为 Notification 设置可穿戴设备独有的特性。
2. 创建一个 NotificationCompat.Builder 的实例，就像本课程先前所说的，设置需要的 Notification 属性。
3. 调用 Notification 上的 extend() 并将 WearableExtender 传进该方法。这在 Notification 上应用了可穿戴设备的选项。
4. 调用 [build()](http://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#build()) 去构建一个 Notification。

例如，以下代码调用 setHintHideIcon() 方法把应用的图标从 Notification 卡片上删掉。

// Create a WearableExtender to add functionality for wearables
NotificationCompat.WearableExtender wearableExtender =
        new NotificationCompat.WearableExtender()
        .setHintHideIcon(true)
        .setBackground(mBitmap);

// Create a NotificationCompat.Builder to build a standard notification
// then extend it with the WearableExtender
Notification notif = new NotificationCompat.Builder(mContext)
        .setContentTitle("New mail from " + sender)
        .setContentText(subject)
        .setSmallIcon(R.drawable.new_mail)
        .extend(wearableExtender)
        .build();

setHintHideIcon() 和 setBackground() 这两个方法是 NotificationCompat.WearableExtender 可用的新 Noticication 特性的两个例子。

Note：setBackground() 中使用的位图在不滚动的背景下应该是 400x400 的分辨率，在支持视差滚动的背景下应该是 640x640。将这些位图放在 res/drawable-nodpi 目录下。将可穿戴 Notification 中使用的其它不是位图的资源放到 res/drawable-hdpi 目录，例如 setContentIcon() 用到的那些资源。

如果开发者需要稍后去读取可穿戴特性的设置，可以使用设置相应的get方法，该例子通过调用 [getHintHideIcon()](http://developer.android.com/reference/android/support/v4/app/NotificationCompat.WearableExtender.html#getHintHideIcon()) 去获取当前 Notification 是否隐藏了图标。

NotificationCompat.WearableExtender wearableExtender =
        new NotificationCompat.WearableExtender(notif);
boolean hintHideIcon = wearableExtender.getHintHideIcon();

传递 Notification

如果开发者想要传递自己的 Notification，请使用 NotificationManagerCompat 的API代替 NotificationManager：

// Get an instance of the NotificationManager service
NotificationManagerCompat notificationManager =
        NotificationManagerCompat.from(mContext);

// Issue the notification with notification manager.
notificationManager.notify(notificationId, notif);

如果开发者使用了framework中的 NotificationManager ，那么 NotificationCompat.WearableExtender 中的一些特性就会失效，所以，请确保使用 NotificationManagerCompat。