java.lang.Object | |
↳ | android.preview.support.wearable.notifications.WearableNotifications |
Helper class that contains wearable extensions for notifications.
Always use the WearableNotifications.Builder
to create instances of this class.
See Creating Notifications for Android Wear for more information on how to use this class.
To create a notification with wearable extensions:
NotificationCompat.Builder
, setting any desired
properties.
WearableNotifications.Builder
, passing in the
NotificationCompat.Builder
as a starting point.
add
and set
methods of WearableNotifications.Builder
.
build()
to create the notification.
NotificationManagerCompat.notify(...)
methods
and not the NotificationManager.notify(...)
methods.
NotificationCompat.Builder builder = new NotificationCompat.Builder(mContext) .setContentTitle("New mail from " + sender.toString()) .setContentText(subject) .setSmallIcon(R.drawable.new_mail); Notification notif = new WearableNotifications.Builder(builder) .setLocalOnly(true) .setMinPriority() .build(); NotificationManagerCompat.from(mContext).notify(0, notif);
When you receive a notification object from the builder, the methods in this class let you access the values of various notification fields in a backward-compatible manner.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
WearableNotifications.Action | Subclass of NotificationCompat.Action that adds additional
wearable extensions for actions. |
||||||||||
WearableNotifications.Builder | Builder class that wraps a NotificationCompat.Builder to add
wearable extensions for 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 of the
setGroup(android.app.Notification, java.lang.String, int)
method. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Get a
WearableNotifications.Action wrapper for the notification at actionIndex
in the actions array. | |||||||||||
Get the number of actions present on this notification.
| |||||||||||
Get the big action icon to be displayed with this notification.
| |||||||||||
Get the big action icon subtext to be shown with a big action icon.
| |||||||||||
Gets the
RemoteInput objects associated with the content intent. | |||||||||||
Gets the
extras field from a notification in a backward-compatible
manner. | |||||||||||
Get the key used to group this notification into a cluster or stack
with other notifications.
| |||||||||||
Get the sort order of this notification within a group of notifications
with the same group key set.
| |||||||||||
Get a hint that this notification's icon should not be displayed.
| |||||||||||
Get whether or not this notification is only relevant to the current device.
| |||||||||||
Get the array of additional pages of content for displaying this notification.
| |||||||||||
Add a big action display to this notification.
| |||||||||||
Add a big action display to this notification.
| |||||||||||
Sets
RemoteInput s to be collected when the user triggers the
contentIntent . | |||||||||||
Set this notification to be part of a group of notifications sharing the same key.
| |||||||||||
Set this notification to be part of a group of notifications sharing the same key.
| |||||||||||
Set a hint that this notification's icon should not be displayed.
| |||||||||||
Set whether or not this notification is only relevant to the current device.
| |||||||||||
Set the priority of this notification to be minimum priority level
(
PRIORITY_MIN ). | |||||||||||
Set additional pages of content to display with this notification.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Default value for the group sort order.
Sentinel value provided to the groupOrder
parameter of the
setGroup(android.app.Notification, java.lang.String, int)
method. This value indicates that this index of the
notification group is the summary of the group.
Get a WearableNotifications.Action
wrapper for the notification at actionIndex
in the actions
array.
notif | the notification to inspect |
---|---|
actionIndex | the index of the desired action |
Get the number of actions present on this notification.
notif | the notification to inspect |
---|
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.
notif | the notification to inspect |
---|
0
if it wasn't setGet the big action icon subtext to be shown with a big action icon.
notif | the notification to inspect |
---|
null
if it wasn't exist.Gets the RemoteInput
objects associated with the content intent.
notif | the notification to inspect |
---|
null
if it doesn't exist
Gets the extras
field from a notification in a backward-compatible
manner. Extras field was supported from JellyBean (API level 16)
forwards. This function will return null on older API levels.
notif | the notification to inspect |
---|
Get the key used to group this notification into a cluster or stack with other notifications. This key is unique within a package.
notif | the notification to inspect |
---|
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.
notif | the notification to inspect |
---|
Get a hint that this notification's icon should not be displayed.
notif | the notification to inspect |
---|
true
if this icon should not be displayed, false otherwise.
The default value is false
if this was never set.
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.
notif | the notification to inspect |
---|
true
if this notification is local only, false
otherwise.
Default value is false
if not set.
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.
notif | the notification to inspect |
---|
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.
notif | the notification to modify |
---|---|
icon | icon to display for the content action. |
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.
notif | the notification to modify |
---|---|
icon | icon to display for the content action. |
subtext | Optional subtext to display with the big action icon. |
Sets RemoteInput
s to be collected when the user triggers the
contentIntent
. These function just as if they were attached to
an WearableNotifications.Action
.
notif | the notification to modify |
---|---|
inputs | array of RemoteInput objects desired from the user.
|
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.
notif | the notification to modify |
---|---|
groupKey | The group key of the group. Unique within a package. |
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.
notif | the notification to modify |
---|---|
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.
|
Set a hint that this notification's icon should not be displayed.
notif | the notification to modify |
---|---|
hintHideIcon | true to hide this icon, false otherwise.
|
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.
notif | the notification to modify |
---|---|
localOnly | set to true to keep the notification on this device only,
false otherwise.
|
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.
notif | the notification to modify |
---|
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.
notif | the notification to modify |
---|---|
pages | the pages to add to the current notification. Replaces any existing pages with this value. |