首页 > 代码库 > Android Wear 开发入门——如何创建一个手机与可穿戴设备关联的通知(Notification)

Android Wear 开发入门——如何创建一个手机与可穿戴设备关联的通知(Notification)

创建通知

为了创建在手机与可穿戴设备中都能展现的通知,可以使用 NotificationCompat.Builder。通过该类创建的通知,系统会处理该通知是否展现在手机或者穿戴设备中。

 

导入必要的类库

在开发之前首先需要导入以下类库

importandroid.support.v4.app.NotificationCompat;
importandroid.support.v4.app.NotificationManagerCompat;
importandroid.support.v4.app.NotificationCompat.WearableExtender;


 

使用Notification Builder创建通知

 v4 support library 库允许开发者使用最新的通知特性,如action button或者large icons,编译环境需要在4以上。

使用支持库开发的通知,需要创建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.BuildernotificationBuilder=
        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());


当这条通知出现在手机上是,使用者可以指定PendingIntent通过使用setContentIntent()方法触发这条通知,当通知出现在手机中时,使用者何以向左滑动来销毁出现的通知。

 

 

添加Action Button

除了定义的setcontentintent()主要内容的行为你可以通过传递一个PendingIntentaddaction()方法添加其他行动

例如,下面的代码展示了与上面代码相同类型的通知,但是添加了一个动作在view的上面。

// 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是以button形式附加在notification一起,在穿戴设备中,该action是以一个大按钮形式出现的,当用户单击该按钮,intent中的内容将在手机中被调起。

 

指定可穿戴设备独有的行为

如果希望可穿戴设备中的行为有别于手机,使用WearableExtender.addAction().当使用该方法,穿戴设备中将不再展现使用NotificationCompat.Builder.addAction().的行为,也就是只显示其在可穿戴设备中。

// 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

开发者可以插入一个Big View形式的内容进入通知,在手机中,用户可以通过展开通知来查看该Big View,在可穿戴设备中,该Big View是默认可见的。

添加这种可展开的内容作为通知,使用 NotificationCompat.Builder 对象中的setStyle() 方法,传递给实例BigTextStyle 或者 InboxStyle样式。

例如下面代码是添加了BigTextStyle 到通知中。

// 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);


为通知添加可穿戴设备特性

如果想添加可穿戴设备中特有的特性,如语音输入等,可以使用NotificationCompat.WearableExtender 类,使用该类分以下几步。

1 创建WearableExtender实例,设置可穿戴设备特有的特性

2 创建NotificationCompat.Builder实例,设置如前文所述

3 调用extend()方法,传递给WearableExtender

4 调用build()创建通知

下面代码使用 setHintHideIcon()移除通知卡片中的图标

// 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();


如果想在后面读取特有的特性的值,可以如下代码所示

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

传送通知

当需要传递通知时,使用 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);


当使用NotificationManager,一些 NotificationCompat.WearableExtender 的特性不能工作

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