public final class

WearableNotifications

extends Object
java.lang.Object
   ↳ android.preview.support.wearable.notifications.WearableNotifications

Class Overview

Helper providing extensions to android notifications for use with wearable devices.

To build notifications with wearable extensions, use the WearableNotifications.Builder class. Notifications created using Builder should be posted to the notification system using the NotificationManagerCompat.notify(...) methods instead of NotificationManager.notify(...).

Once a notification is built, a variety of methods are provide in this utility to access the value of various notification fields in a backwards compatible manner.

Summary

Nested Classes
class WearableNotifications.Action Subclass of NotificationCompat.Action which adds support for additional wearable extensions. 
class WearableNotifications.Builder Builder object that wraps a NotificationCompat.Builder to provide methods for adding wearable extensions to a notification. 
Constants
int GROUP_ORDER_DEFAULT Default value for the group sort order.
int GROUP_ORDER_SUMMARY Sentinel value provided to the groupOrder parameter setGroup(Notification, String) to indicate that this member of a notification group is the summary of the group.
Public Methods
static WearableNotifications.Action getAction(Notification notif, int actionIndex)
Get a WearableNotifications.Action wrapper for the notification at index actionIndex in the actions array.
static int getActionCount(Notification notif)
Get the number of actions present on this notification.
static int getBigActionIcon(Notification notif)
Get the big action icon to be displayed with this notification.
static CharSequence getBigActionSubtext(Notification notif)
Get the big action icon subtext to be shown with a big action icon.
static RemoteInput[] getContentIntentRemoteInputs(Notification notif)
Gets the RemoteInputs associated with the content intent.
static Bundle getExtras(Notification notif)
Gets the extras field from a notification in a backwards compatible manner.
static String getGroupKey(Notification notif)
Get the key used to group this notification into a cluster or stack with other notifications.
static int getGroupOrder(Notification notif)
Get the sort order of this notification within a group of notifications with the same group key set.
static boolean getHintHideIcon(Notification notif)
Get a hint that this notification's icon should not be displayed.
static boolean getLocalOnly(Notification notif)
Get whether or not this notification is only relevant to the current device.
static Notification[] getPages(Notification notif)
Get the array of additional pages of content for displaying this notification.
static void setBigActionIcon(Notification notif, int icon)
Add a big action display to this notification.
static void setBigActionIcon(Notification notif, int icon, CharSequence subtext)
Add a big action display to this notification.
static void setContentIntentRemoteInputs(Notification notif, RemoteInput[] inputs)
Sets RemoteInputs to be collected when the user triggers the contentIntent.
static void setGroup(Notification notif, String groupKey)
Set this notification to be part of a group of notifications sharing the same key.
static void setGroup(Notification notif, String groupKey, int groupOrder)
Set this notification to be part of a group of notifications sharing the same key.
static void setHintHideIcon(Notification notif, boolean hintHideIcon)
Set a hint that this notification's icon should not be displayed.
static void setLocalOnly(Notification notif, boolean localOnly)
Set whether or not this notification is only relevant to the current device.
static void setMinPriority(Notification notif)
Set the priority of this notification to be minimum priority level (PRIORITY_MIN).
static void setPages(Notification notif, Notification[] pages)
Set additional pages of content to display with this notification.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final int GROUP_ORDER_DEFAULT

Default value for the group sort order.

Constant Value: 0 (0x00000000)

public static final int GROUP_ORDER_SUMMARY

Sentinel value provided to the groupOrder parameter setGroup(Notification, String) to indicate that this member of a notification group is the summary of the group.

Constant Value: -1 (0xffffffff)

Public Methods

public static WearableNotifications.Action getAction (Notification notif, int actionIndex)

Get a WearableNotifications.Action wrapper for the notification at index actionIndex in the actions array.

public static int getActionCount (Notification notif)

Get the number of actions present on this notification.

See Also

public static int getBigActionIcon (Notification notif)

Get the big action icon to be displayed with this notification. Big actions show a hint to users about the action taken when the content intent is triggered.

public static CharSequence getBigActionSubtext (Notification notif)

Get the big action icon subtext to be shown with a big action icon.

public static RemoteInput[] getContentIntentRemoteInputs (Notification notif)

Gets the RemoteInputs associated with the content intent.

public static Bundle getExtras (Notification notif)

Gets the extras field from a notification in a backwards compatible manner. Extras field was supported from JellyBean (Api level 16) forwards. This function will return null on older api levels.

public static String getGroupKey (Notification notif)

Get the key used to group this notification into a cluster or stack with other notifications. This key is unique within a package.

public static int getGroupOrder (Notification notif)

Get the sort order of this notification within a group of notifications with the same group key set. Group orders are 0-indexed integers that are used to sort notifications in ascending order. Can also be the sentinel value GROUP_ORDER_SUMMARY if this is the summary notification for a group.

public static boolean getHintHideIcon (Notification notif)

Get a hint that this notification's icon should not be displayed.

public static boolean getLocalOnly (Notification notif)

Get whether or not this notification is only relevant to the current device.

Some notifications can be bridged to other devices for remote display. If this hint is set, it is recommended that this notification not be bridged.

public static Notification[] getPages (Notification notif)

Get the array of additional pages of content for displaying this notification. The current notification forms the first page, and elements within this array form subsequent pages. This field can be used to separate a notification into multiple sections.

public static void setBigActionIcon (Notification notif, int icon)

Add a big action display to this notification. Big actions show a hint to users about the action taken when the content intent is triggered.

Parameters
icon Icon to display for the content action.

public static void setBigActionIcon (Notification notif, int icon, CharSequence subtext)

Add a big action display to this notification. Big actions show a hint to users about the action taken when the content intent is triggered.

Parameters
icon Icon to display for the content action.
subtext Optional subtext to display with the big action icon.

public static void setContentIntentRemoteInputs (Notification notif, RemoteInput[] inputs)

Sets RemoteInputs to be collected when the user triggers the contentIntent. These function just as if they were attached to an WearableNotifications.Action.

public static void setGroup (Notification notif, String groupKey)

Set this notification to be part of a group of notifications sharing the same key. Grouped notifications may display in a cluster or stack on devices which support such rendering. Use the default ordering within a group.

Parameters
groupKey The group key of the group. Unique within a package.

public static void setGroup (Notification notif, String groupKey, int groupOrder)

Set this notification to be part of a group of notifications sharing the same key. Grouped notifications may display in a cluster or stack on devices which support such rendering.

Parameters
groupKey The group key of the group. Unique within a package.
groupOrder The 0-indexed sort order within the group. Can also be set to the sentinel value GROUP_ORDER_SUMMARY to mark this notification as being the group summary.

public static void setHintHideIcon (Notification notif, boolean hintHideIcon)

Set a hint that this notification's icon should not be displayed.

public static void setLocalOnly (Notification notif, boolean localOnly)

Set whether or not this notification is only relevant to the current device.

Some notifications can be bridged to other devices for remote display. This hint can be set to recommend this notification not be bridged.

public static void setMinPriority (Notification notif)

Set the priority of this notification to be minimum priority level (PRIORITY_MIN). When set via WearableNotifications, these minimum priority notifications will bypass the notification manager on platforms that do not support ambient level notifications.

public static void setPages (Notification notif, Notification[] pages)

Set additional pages of content to display with this notification. The current notification forms the first page, and pages set using this function form subsequent pages. This field can be used to separate a notification into multiple sections.