Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public class

NotificationCompat

extends Object
java.lang.Object
   ↳ android.support.v4.app.NotificationCompat

Class Overview

Helper for accessing features in Notification introduced after API level 4 in a backwards compatible fashion.

Summary

Nested Classes
class NotificationCompat.Action Structure to encapsulate a named action that can be shown as part of this notification. 
class NotificationCompat.BigPictureStyle Helper class for generating large-format notifications that include a large image attachment. 
class NotificationCompat.BigTextStyle Helper class for generating large-format notifications that include a lot of text. 
class NotificationCompat.Builder Builder class for NotificationCompat objects. 
interface NotificationCompat.Extender Extender interface for use with extend(NotificationCompat.Extender)
class NotificationCompat.InboxStyle Helper class for generating large-format notifications that include a list of (up to 5) strings. 
class NotificationCompat.Style An object that can apply a rich notification style to a Notification.Action.Builder object. 
class NotificationCompat.WearableExtender Helper class to add wearable extensions to notifications. 
Constants
int DEFAULT_ALL Use all default values (where applicable).
int DEFAULT_LIGHTS Use the default notification lights.
int DEFAULT_SOUND Use the default notification sound.
int DEFAULT_VIBRATE Use the default notification vibrate.
String EXTRA_INFO_TEXT Notification extras key: this is a small piece of additional text as supplied to setContentInfo(CharSequence) .
String EXTRA_LARGE_ICON Notification extras key: this is a bitmap to be used instead of the small icon when showing the notification payload, as supplied to setLargeIcon(android.graphics.Bitmap) .
String EXTRA_LARGE_ICON_BIG Notification extras key: this is a bitmap to be used instead of the one from setLargeIcon(android.graphics.Bitmap) when the notification is shown in its expanded form, as supplied to bigLargeIcon(android.graphics.Bitmap) .
String EXTRA_PEOPLE Notification extras key: An array of people that this notification relates to, specified by contacts provider contact URI.
String EXTRA_PICTURE Notification extras key: this is a bitmap to be shown in NotificationCompat.BigPictureStyle expanded notifications, supplied to bigPicture(android.graphics.Bitmap) .
String EXTRA_PROGRESS Notification extras key: this is the progress value supplied to setProgress(int, int, boolean) .
String EXTRA_PROGRESS_INDETERMINATE Notification extras key: whether the progress bar is indeterminate, supplied to setProgress(int, int, boolean) .
String EXTRA_PROGRESS_MAX Notification extras key: this is the maximum value supplied to setProgress(int, int, boolean) .
String EXTRA_SHOW_CHRONOMETER Notification extras key: whether the when field set using setWhen(long) should be shown as a count-up timer (specifically a Chronometer ) instead of a timestamp, as supplied to setUsesChronometer(boolean) .
String EXTRA_SMALL_ICON Notification extras key: this is the resource ID of the notification's main small icon, as supplied to setSmallIcon(int) .
String EXTRA_SUB_TEXT Notification extras key: this is a third line of text, as supplied to setSubText(CharSequence) .
String EXTRA_SUMMARY_TEXT Notification extras key: this is a line of summary information intended to be shown alongside expanded notifications, as supplied to (e.g.) setSummaryText(CharSequence) .
String EXTRA_TEXT Notification extras key: this is the main text payload, as supplied to setContentText(CharSequence) .
String EXTRA_TEXT_LINES Notification extras key: An array of CharSequences to show in NotificationCompat.InboxStyle expanded notifications, each of which was supplied to addLine(CharSequence) .
String EXTRA_TITLE Notification extras key: this is the title of the notification, as supplied to setContentTitle(CharSequence) .
String EXTRA_TITLE_BIG Notification extras key: this is the title of the notification when shown in expanded form, e.g.
int FLAG_AUTO_CANCEL Bit set in the Notification flags field if the notification should be canceled when it is clicked by the user.
int FLAG_FOREGROUND_SERVICE Bit set in the Notification flags field if this notification represents a currently running service.
int FLAG_GROUP_SUMMARY Bit set in the Notification flags field if this notification is the group summary for a group of notifications.
int FLAG_HIGH_PRIORITY This constant is deprecated. Use setPriority(int) with a positive value.
int FLAG_INSISTENT Bit set in the Notification flags field if the audio will be repeated until the notification is cancelled or the notification window is opened.
int FLAG_LOCAL_ONLY Bit set in the Notification flags field if this notification is relevant to the current device only and it is not recommended that it bridge to other devices.
int FLAG_NO_CLEAR Bit set in the Notification flags field if the notification should not be canceled when the user clicks the Clear all button.
int FLAG_ONGOING_EVENT Bit set in the Notification flags field if this notification is in reference to something that is ongoing, like a phone call.
int FLAG_ONLY_ALERT_ONCE Bit set in the Notification flags field if the notification's sound, vibrate and ticker should only be played if the notification is not already showing.
int FLAG_SHOW_LIGHTS Bit set in the Notification flags field when LEDs should be turned on for this notification.
int PRIORITY_DEFAULT Default notification priority for setPriority(int) .
int PRIORITY_HIGH Higher notification priority for setPriority(int) , for more important notifications or alerts.
int PRIORITY_LOW Lower notification priority for setPriority(int) , for items that are less important.
int PRIORITY_MAX Highest notification priority for setPriority(int) , for your application's most important items that require the user's prompt attention or input.
int PRIORITY_MIN Lowest notification priority for setPriority(int) ; these items might not be shown to the user except under special circumstances, such as detailed notification logs.
int STREAM_DEFAULT Use this constant as the value for audioStreamType to request that the default stream type for notifications be used.
Public Constructors
NotificationCompat ()
Public Methods
static NotificationCompat.Action getAction ( Notification notif, int actionIndex)
Get an action on this notification in a backwards compatible manner.
static int getActionCount ( Notification notif)
Get the number of actions in this notification in a backwards compatible manner.
static Bundle getExtras ( Notification notif)
Gets the extras field from a notification in a backwards compatible manner.
static String getGroup ( Notification notif)
Get the key used to group this notification into a cluster or stack with other notifications on devices which support such rendering.
static boolean getLocalOnly ( Notification notif)
Get whether or not this notification is only relevant to the current device.
static String getSortKey ( Notification notif)
Get a sort key that orders this notification among other notifications from the same package.
static boolean isGroupSummary ( Notification notif)
Get whether this notification to be the group summary for a group of notifications.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final int DEFAULT_ALL

Use all default values (where applicable).

Constant Value: -1 (0xffffffff)

public static final int DEFAULT_LIGHTS

Use the default notification lights. This will ignore the FLAG_SHOW_LIGHTS bit, and values set with setLights(int, int, int) .

Constant Value: 4 (0x00000004)

public static final int DEFAULT_SOUND

Use the default notification sound. This will ignore any sound set using setSound(Uri)

Constant Value: 1 (0x00000001)

public static final int DEFAULT_VIBRATE

Use the default notification vibrate. This will ignore any vibrate set using setVibrate(long[]) . Using phone vibration requires the VIBRATE permission.

Constant Value: 2 (0x00000002)

public static final String EXTRA_INFO_TEXT

Notification extras key: this is a small piece of additional text as supplied to setContentInfo(CharSequence) .

Constant Value: "android.infoText"

public static final String EXTRA_LARGE_ICON

Notification extras key: this is a bitmap to be used instead of the small icon when showing the notification payload, as supplied to setLargeIcon(android.graphics.Bitmap) .

Constant Value: "android.largeIcon"

public static final String EXTRA_LARGE_ICON_BIG

Notification extras key: this is a bitmap to be used instead of the one from setLargeIcon(android.graphics.Bitmap) when the notification is shown in its expanded form, as supplied to bigLargeIcon(android.graphics.Bitmap) .

Constant Value: "android.largeIcon.big"

public static final String EXTRA_PEOPLE

Notification extras key: An array of people that this notification relates to, specified by contacts provider contact URI.

Constant Value: "android.people"

public static final String EXTRA_PICTURE

Notification extras key: this is a bitmap to be shown in NotificationCompat.BigPictureStyle expanded notifications, supplied to bigPicture(android.graphics.Bitmap) .

Constant Value: "android.picture"

public static final String EXTRA_PROGRESS

Notification extras key: this is the progress value supplied to setProgress(int, int, boolean) .

Constant Value: "android.progress"

public static final String EXTRA_PROGRESS_INDETERMINATE

Notification extras key: whether the progress bar is indeterminate, supplied to setProgress(int, int, boolean) .

Constant Value: "android.progressIndeterminate"

public static final String EXTRA_PROGRESS_MAX

Notification extras key: this is the maximum value supplied to setProgress(int, int, boolean) .

Constant Value: "android.progressMax"

public static final String EXTRA_SHOW_CHRONOMETER

Notification extras key: whether the when field set using setWhen(long) should be shown as a count-up timer (specifically a Chronometer ) instead of a timestamp, as supplied to setUsesChronometer(boolean) .

Constant Value: "android.showChronometer"

public static final String EXTRA_SMALL_ICON

Notification extras key: this is the resource ID of the notification's main small icon, as supplied to setSmallIcon(int) .

Constant Value: "android.icon"

public static final String EXTRA_SUB_TEXT

Notification extras key: this is a third line of text, as supplied to setSubText(CharSequence) .

Constant Value: "android.subText"

public static final String EXTRA_SUMMARY_TEXT

Notification extras key: this is a line of summary information intended to be shown alongside expanded notifications, as supplied to (e.g.) setSummaryText(CharSequence) .

Constant Value: "android.summaryText"

public static final String EXTRA_TEXT

Notification extras key: this is the main text payload, as supplied to setContentText(CharSequence) .

Constant Value: "android.text"

public static final String EXTRA_TEXT_LINES

Notification extras key: An array of CharSequences to show in NotificationCompat.InboxStyle expanded notifications, each of which was supplied to addLine(CharSequence) .

Constant Value: "android.textLines"

public static final String EXTRA_TITLE

Notification extras key: this is the title of the notification, as supplied to setContentTitle(CharSequence) .

Constant Value: "android.title"

public static final String EXTRA_TITLE_BIG

Notification extras key: this is the title of the notification when shown in expanded form, e.g. as supplied to setBigContentTitle(CharSequence) .

Constant Value: "android.title.big"

public static final int FLAG_AUTO_CANCEL

Bit set in the Notification flags field if the notification should be canceled when it is clicked by the user.

Constant Value: 16 (0x00000010)

public static final int FLAG_FOREGROUND_SERVICE

Bit set in the Notification flags field if this notification represents a currently running service. This will normally be set for you by startForeground(int, Notification) .

Constant Value: 64 (0x00000040)

public static final int FLAG_GROUP_SUMMARY

Bit set in the Notification flags field if this notification is the group summary for a group of notifications. Grouped notifications may display in a cluster or stack on devices which support such rendering. Requires a group key also be set using setGroup(String) .

Constant Value: 512 (0x00000200)

public static final int FLAG_HIGH_PRIORITY

This constant is deprecated.
Use setPriority(int) with a positive value.

Obsolete flag indicating high-priority notifications; use the priority field instead.

Constant Value: 128 (0x00000080)

public static final int FLAG_INSISTENT

Bit set in the Notification flags field if the audio will be repeated until the notification is cancelled or the notification window is opened.

Constant Value: 4 (0x00000004)

public static final int FLAG_LOCAL_ONLY

Bit set in the Notification flags field if this notification is relevant to the current device only and it is not recommended that it bridge to other devices.

Constant Value: 256 (0x00000100)

public static final int FLAG_NO_CLEAR

Bit set in the Notification flags field if the notification should not be canceled when the user clicks the Clear all button.

Constant Value: 32 (0x00000020)

public static final int FLAG_ONGOING_EVENT

Bit set in the Notification flags field if this notification is in reference to something that is ongoing, like a phone call. It should not be set if this notification is in reference to something that happened at a particular point in time, like a missed phone call.

Constant Value: 2 (0x00000002)

public static final int FLAG_ONLY_ALERT_ONCE

Bit set in the Notification flags field if the notification's sound, vibrate and ticker should only be played if the notification is not already showing.

Constant Value: 8 (0x00000008)

public static final int FLAG_SHOW_LIGHTS

Bit set in the Notification flags field when LEDs should be turned on for this notification.

Constant Value: 1 (0x00000001)

public static final int PRIORITY_DEFAULT

Default notification priority for setPriority(int) . If your application does not prioritize its own notifications, use this value for all notifications.

Constant Value: 0 (0x00000000)

public static final int PRIORITY_HIGH

Higher notification priority for setPriority(int) , for more important notifications or alerts. The UI may choose to show these items larger, or at a different position in notification lists, compared with your app's PRIORITY_DEFAULT items.

Constant Value: 1 (0x00000001)

public static final int PRIORITY_LOW

Lower notification priority for setPriority(int) , for items that are less important. The UI may choose to show these items smaller, or at a different position in the list, compared with your app's PRIORITY_DEFAULT items.

Constant Value: -1 (0xffffffff)

public static final int PRIORITY_MAX

Highest notification priority for setPriority(int) , for your application's most important items that require the user's prompt attention or input.

Constant Value: 2 (0x00000002)

public static final int PRIORITY_MIN

Lowest notification priority for setPriority(int) ; these items might not be shown to the user except under special circumstances, such as detailed notification logs.

Constant Value: -2 (0xfffffffe)

public static final int STREAM_DEFAULT

Use this constant as the value for audioStreamType to request that the default stream type for notifications be used. Currently the default stream type is STREAM_NOTIFICATION .

Constant Value: -1 (0xffffffff)

Public Constructors

public NotificationCompat ()

Public Methods

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

Get an action on this notification in a backwards compatible manner. Actions were supported from JellyBean (Api level 16) forwards.

Parameters
notif The notification to inspect.
actionIndex The index of the action to retrieve.

public static int getActionCount ( Notification notif)

Get the number of actions in this notification in a backwards compatible manner. Actions were supported from JellyBean (Api level 16) forwards.

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 getGroup ( Notification notif)

Get the key used to group this notification into a cluster or stack with other notifications on devices which support such rendering.

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 recommend that this notification not be bridged.

public static String getSortKey ( Notification notif)

Get a sort key that orders this notification among other notifications from the same package. This can be useful if an external sort was already applied and an app would like to preserve this. Notifications will be sorted lexicographically using this value, although providing different priorities in addition to providing sort key may cause this value to be ignored.

This sort key can also be used to order members of a notification group. See setGroup(String) .

public static boolean isGroupSummary ( Notification notif)

Get whether this notification to be the group summary for a group of notifications. Grouped notifications may display in a cluster or stack on devices which support such rendering. Requires a group key also be set using setGroup(String) .

Returns
  • Whether this notification is a group summary.