创建Notification

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

为了创建一个手持设备上的并且也能同时发送给可穿戴设备的Notification，需要使用 NotificationCompat.Builder。当你使用这个类创建Notification之后，如何正确展示的工作就交由系统去完成，无论他们出现在手持式设备上还是可穿戴设备上。

注意: Notification如果使用RemoteViews，便能够自定义layout，并且可穿戴设备上只显示文本和icon。但是，通过创建一个运行在可穿戴设备上的应用，开发者能够使用自定义的 card layouts 创建自定义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 button或采用large icon，而且兼容Android1.6（API level4）及以上。

为了通过support library创建一个Notification，你需要创建一个NotificationCompat.Builder的实例，然后通过notify()去激活。例如：

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()设置的PendingIntent。当该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。

提示: 如果你的Notification包含了一个"Reply"的action(例如短信类app)，你可以通过支持直接从Android可穿戴设备返回的语音输入，来加强该功能的使用。更多信息，详见Receiving Voice Input from a 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"的style来插入扩展文本。在手持式设备上，用户能够通过扩展的Notification看见big view的内容。在可穿戴式设备上，big view内容是默认可见的。

可以通过对NotificationCompat.Builder的对象调用setStyle()，设置参数为BigTextStyle或InboxStyle的实例。

比如，下面的代码为事件的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上的设计，详见Design Principles of Android Wear。

为Notification添加可穿戴式特性

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

1. 创建一个WearableExtender的实例，设置可穿戴独有的Notification特性。
2. 创建一个NotificationCompat.Builder的实例，就像本课程先前所说的，设置需要的Notification属性。
3. 调用build()去build一个Notification。

例如，以下代码调用setHintHideIcon()把app 的icon从Notification的卡片上remove掉。

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

// 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()方法是NotificationCompat.WearableExtender提供的Notification的一个接口。

如果开发者需要稍后去读取可穿戴特性设置的内容项，可以使用相应的get方法，该例子通过调用getHintHideIcon()去获取当前Notification是否隐藏了icon。

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。

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

NotificationCompat.WearableExtender的API允许开发者为Notification、stack Notification等添加额外的内容页。下面的课程将学习这些特性。

下一课：在Notifcation中接收语音输入