Most visited

Recently visited

Results for

Added in API level 20

Summary: Constants | Ctors | Methods | Inherited Methods | [Expand All]

Notification.WearableExtender

public static final class Notification.WearableExtender
extends Object implements Notification.Extender

java.lang.Object
↳	android.app.Notification.WearableExtender

Helper class to add wearable extensions to notifications.

See Creating Notifications for Android Wear for more information on how to use this class.

To create a notification with wearable extensions:

Create a Notification.Builder, setting any desired properties.
Create a Notification.WearableExtender.
Set wearable-specific properties using the add and set methods of Notification.WearableExtender.
Call extend(Notification.Extender) to apply the extensions to a notification.
Post the notification to the notification system with the NotificationManager.notify(...) methods.

 Notification notif = new Notification.Builder(mContext)
         .setContentTitle("New mail from " + sender.toString())
         .setContentText(subject)
         .setSmallIcon(R.drawable.new_mail)
         .extend(new Notification.WearableExtender()
                 .setContentIcon(R.drawable.new_mail))
         .build();
 NotificationManager notificationManger =
         (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
 notificationManger.notify(0, notif);

Wearable extensions can be accessed on an existing notification by using the WearableExtender(Notification) constructor, and then using the get methods to access values.

 Notification.WearableExtender wearableExtender = new Notification.WearableExtender(
         notification);
 List<Notification> pages = wearableExtender.getPages();

Summary

Constants
`int`	`SCREEN_TIMEOUT_LONG` Sentinel value for use with `setHintScreenTimeout(int)` to keep the screen on for a longer amount of time when this notification is displayed on the screen.
`int`	`SCREEN_TIMEOUT_SHORT` Sentinel value for use with `setHintScreenTimeout(int)` to keep the screen on for a short amount of time when this notification is displayed on the screen.
`int`	`SIZE_DEFAULT` Size value for use with `setCustomSizePreset(int)` to show this notification with default sizing.
`int`	`SIZE_FULL_SCREEN` Size value for use with `setCustomSizePreset(int)` to show this notification full screen.
`int`	`SIZE_LARGE` Size value for use with `setCustomSizePreset(int)` to show this notification with a large size.
`int`	`SIZE_MEDIUM` Size value for use with `setCustomSizePreset(int)` to show this notification with a medium size.
`int`	`SIZE_SMALL` Size value for use with `setCustomSizePreset(int)` to show this notification with a small size.
`int`	`SIZE_XSMALL` Size value for use with `setCustomSizePreset(int)` to show this notification with an extra small size.
`int`	`UNSET_ACTION_INDEX` Sentinel value for an action index that is unset.

Public constructors
`Notification.WearableExtender()` Create a `Notification.WearableExtender` with default options.
`Notification.WearableExtender(Notification notif)`

Public methods
`Notification.WearableExtender`	`addAction(Notification.Action action)` Add a wearable action to this notification.
`Notification.WearableExtender`	`addActions(List<Notification.Action> actions)` Adds wearable actions to this notification.
`Notification.WearableExtender`	`addPage(Notification page)` Add an additional page of content to display with this notification.
`Notification.WearableExtender`	`addPages(List<Notification> pages)` Add additional pages of content to display with this notification.
`Notification.WearableExtender`	`clearActions()` Clear all wearable actions present on this builder.
`Notification.WearableExtender`	`clearPages()` Clear all additional pages present on this builder.
`Notification.WearableExtender`	`clone()` Creates and returns a copy of this object.
`Notification.Builder`	`extend(Notification.Builder builder)` Apply wearable extensions to a notification that is being built.
`List<Notification.Action>`	`getActions()` Get the wearable actions present on this notification.
`Bitmap`	`getBackground()` Get a background image to be displayed behind the notification content.
`int`	`getContentAction()` Get the index of the notification action, if any, that was specified as being clickable with the content of this notification.
`int`	`getContentIcon()` Get an icon that goes with the content of this notification.
`int`	`getContentIconGravity()` Get the gravity that the content icon should have within the notification display.
`boolean`	`getContentIntentAvailableOffline()` Get whether the content intent is available when the wearable device is not connected to a companion device.
`int`	`getCustomContentHeight()` Get the custom height in pixels for the display of this notification's content.
`int`	`getCustomSizePreset()` Get the custom size preset for the display of this notification out of the available presets found in `Notification.WearableExtender`, e.g.
`String`	`getDismissalId()` Returns the dismissal id of the notification.
`PendingIntent`	`getDisplayIntent()` Get the intent to launch inside of an activity view when displaying this notification.
`int`	`getGravity()` Get the gravity that this notification should have within the available viewport space.
`boolean`	`getHintAmbientBigPicture()` Get a hint that this notification's `Notification.BigPictureStyle` (if present) should be converted to low-bit and displayed in ambient mode, especially useful for barcodes and qr codes, as well as other simple black-and-white tickets.
`boolean`	`getHintAvoidBackgroundClipping()` Get a hint that this notification's background should not be clipped if possible, and should instead be resized to fully display on the screen, retaining the aspect ratio of the image.
`boolean`	`getHintContentIntentLaunchesActivity()` Get a hint that this notification's content intent will launch an `Activity` directly, telling the platform that it can generate the appropriate transitions
`boolean`	`getHintHideIcon()` Get a hint that this notification's icon should not be displayed.
`int`	`getHintScreenTimeout()` Get the duration, in milliseconds, that the screen should remain on for when this notification is displayed.
`boolean`	`getHintShowBackgroundOnly()` Get a visual hint that only the background image of this notification should be displayed, and other semantic content should be hidden.
`List<Notification>`	`getPages()` Get the array of additional pages of content for displaying this notification.
`boolean`	`getStartScrollBottom()` Get whether the scrolling position for the contents of this notification should start at the bottom of the contents instead of the top when the contents are too long to display within the screen.
`Notification.WearableExtender`	`setBackground(Bitmap background)` Set a background image to be displayed behind the notification content.
`Notification.WearableExtender`	`setContentAction(int actionIndex)` Set an action from this notification's actions to be clickable with the content of this notification.
`Notification.WearableExtender`	`setContentIcon(int icon)` Set an icon that goes with the content of this notification.
`Notification.WearableExtender`	`setContentIconGravity(int contentIconGravity)` Set the gravity that the content icon should have within the notification display.
`Notification.WearableExtender`	`setContentIntentAvailableOffline(boolean contentIntentAvailableOffline)` Set whether the content intent is available when the wearable device is not connected to a companion device.
`Notification.WearableExtender`	`setCustomContentHeight(int height)` Set the custom height in pixels for the display of this notification's content.
`Notification.WearableExtender`	`setCustomSizePreset(int sizePreset)` Set the custom size preset for the display of this notification out of the available presets found in `Notification.WearableExtender`, e.g.
`Notification.WearableExtender`	`setDismissalId(String dismissalId)` When you post a notification, if you set the dismissal id field, then when that notification is canceled, notifications on other wearables and the paired Android phone having that same dismissal id will also be canceled.
`Notification.WearableExtender`	`setDisplayIntent(PendingIntent intent)` Set an intent to launch inside of an activity view when displaying this notification.
`Notification.WearableExtender`	`setGravity(int gravity)` Set the gravity that this notification should have within the available viewport space.
`Notification.WearableExtender`	`setHintAmbientBigPicture(boolean hintAmbientBigPicture)` Set a hint that this notification's `Notification.BigPictureStyle` (if present) should be converted to low-bit and displayed in ambient mode, especially useful for barcodes and qr codes, as well as other simple black-and-white tickets.
`Notification.WearableExtender`	`setHintAvoidBackgroundClipping(boolean hintAvoidBackgroundClipping)` Set a hint that this notification's background should not be clipped if possible, and should instead be resized to fully display on the screen, retaining the aspect ratio of the image.
`Notification.WearableExtender`	`setHintContentIntentLaunchesActivity(boolean hintContentIntentLaunchesActivity)` Set a hint that this notification's content intent will launch an `Activity` directly, telling the platform that it can generate the appropriate transitions.
`Notification.WearableExtender`	`setHintHideIcon(boolean hintHideIcon)` Set a hint that this notification's icon should not be displayed.
`Notification.WearableExtender`	`setHintScreenTimeout(int timeout)` Set a hint that the screen should remain on for at least this duration when this notification is displayed on the screen.
`Notification.WearableExtender`	`setHintShowBackgroundOnly(boolean hintShowBackgroundOnly)` Set a visual hint that only the background image of this notification should be displayed, and other semantic content should be hidden.
`Notification.WearableExtender`	`setStartScrollBottom(boolean startScrollBottom)` Set whether the scrolling position for the contents of this notification should start at the bottom of the contents instead of the top when the contents are too long to display within the screen.

Inherited methods

From class


  
    java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

From interface


  
    android.app.Notification.Extender

Constants

SCREEN_TIMEOUT_LONG

Added in API level 22

int SCREEN_TIMEOUT_LONG

Sentinel value for use with setHintScreenTimeout(int) to keep the screen on for a longer amount of time when this notification is displayed on the screen.

Constant Value: -1 (0xffffffff)

SCREEN_TIMEOUT_SHORT

Added in API level 22

int SCREEN_TIMEOUT_SHORT

Sentinel value for use with setHintScreenTimeout(int) to keep the screen on for a short amount of time when this notification is displayed on the screen. This is the default value.

Constant Value: 0 (0x00000000)

SIZE_DEFAULT

Added in API level 20

int SIZE_DEFAULT

Size value for use with setCustomSizePreset(int) to show this notification with default sizing.

For custom display notifications created using setDisplayIntent(PendingIntent), the default is SIZE_MEDIUM. All other notifications size automatically based on their content.

Constant Value: 0 (0x00000000)