为可穿戴设备创建Notification

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

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

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

    1. import android.support.v4.app.NotificationCompat;
    2. import android.support.v4.app.NotificationManagerCompat;
    3. import android.support.v4.app.NotificationCompat.WearableExtender;

    通过Notification Builder创建Notification

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

    为了通过support library创建一个Notification，我们需要创建一个 的实例，然后通过将该实例传给 notify()) 来发出 Notification。例如：

    1. int notificationId = 001;
    2. // Build intent for notification content
    3. Intent viewIntent = new Intent(this, ViewEventActivity.class);
    4. viewIntent.putExtra(EXTRA_EVENT_ID, eventId);
    5. PendingIntent viewPendingIntent =
    6.         PendingIntent.getActivity(this, 0, viewIntent, 0);
    8. NotificationCompat.Builder notificationBuilder =
    9.         new NotificationCompat.Builder(this)
    10.         .setSmallIcon(R.drawable.ic_event)
    11.         .setContentTitle(eventTitle)
    12.         .setContentText(eventLocation)
    13.         .setContentIntent(viewPendingIntent);
    15. // Get an instance of the NotificationManager service
    16.         NotificationManagerCompat.from(this);
    18. // Build the notification and issues it with notification manager.

    当该Notification出现在手持设备上时，用户能够通过触摸Notification来触发之前通过设置的PendingIntent。当该Notification出现在可穿戴设备上时，用户能够通过向左滑动该Notification显示Open的action，点击这个action能够激活手持设备上的Intent。

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

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

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

    可穿戴式独有的 Actions

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

    1. // Create an intent for the reply action
    2. Intent actionIntent = new Intent(this, ActionActivity.class);
    3. PendingIntent actionPendingIntent =
    4.         PendingIntent.getActivity(this, 0, actionIntent,
    5.                 PendingIntent.FLAG_UPDATE_CURRENT);
    7. // Create the action
    8. NotificationCompat.Action action =
    9.         new NotificationCompat.Action.Builder(R.drawable.ic_action,
    10.                 getString(R.string.label, actionPendingIntent))
    11.                 .build();
    13. // Build the notification and add the action via WearableExtender
    14. Notification notification =
    15.         new NotificationCompat.Builder(mContext)
    16.                 .setSmallIcon(R.drawable.ic_message)
    17.                 .setContentTitle(getString(R.string.title))
    18.                 .setContentText(getString(R.string.content))
    19.                 .extend(new WearableExtender().addAction(action))
    20.                 .build();

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

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

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

    1. // Specify the 'big view' content to display the long
    3. bigStyle.bigText(eventDescription);
    5. NotificationCompat.Builder notificationBuilder =
    6.         new NotificationCompat.Builder(this)
    7.         .setSmallIcon(R.drawable.ic_event)
    8.         .setLargeIcon(BitmapFractory.decodeResource(
    9.                 getResources(), R.drawable.notif_background))
    10.         .setContentTitle(eventTitle)
    11.         .setContentText(eventLocation)
    12.         .setContentIntent(viewPendingIntent)
    13.         .addAction(R.drawable.ic_map,
    14.                 getString(R.string.map), mapPendingIntent)
    15.         .setStyle(bigStyle);

    为Notification添加可穿戴式特性

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

    1. 创建一个 WearableExtender 的实例，为 Notification 设置可穿戴设备独有的特性。
    2. 创建一个 的实例，就像本课程先前所说的，设置需要的 Notification 属性。
    3. 调用 Notification 上的 extend()) 并将 传进该方法。这在 Notification 上应用了可穿戴设备的选项。
    4. 调用 build()) 去构建一个 Notification。

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

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

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

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

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

    1. // Get an instance of the NotificationManager service
    2. NotificationManagerCompat notificationManager =
    3.         NotificationManagerCompat.from(mContext);
    5. notificationManager.notify(notificationId, notif);

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

    下一课：