Notification

Use all default values (where applicable).

Use the default notification lights. This will ignore the FLAG_SHOW_LIGHTS bit, and ledARGB, ledOffMS, or ledOnMS.

Use the default notification sound. This will ignore any given sound.

Use the default notification vibrate. This will ignore any given vibrate. Using phone vibration requires the VIBRATE permission.

Bit to be bitwise-ored into the flags field that should be set if the notification should be canceled when it is clicked by the user. On tablets, the

Bit to be bitwise-ored into the flags field that should be set if this notification represents a currently running service. This will normally be set for you by startForeground(int, Notification).

Bit to be bitwise-ored into the flags field that should be set if this notification represents a high-priority event that may be shown to the user even if notifications are otherwise unavailable (that is, when the status bar is hidden). This flag is ideally used in conjunction with fullScreenIntent.

Bit to be bitwise-ored into the flags field that if set, the audio will be repeated until the notification is cancelled or the notification window is opened.

Bit to be bitwise-ored into the flags field that should be set if the notification should not be canceled when the user clicks the Clear all button.

Bit to be bitwise-ored into the flags field that should be set 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.

Bit to be bitwise-ored into the flags field that should be set if you want the sound and/or vibration play each time the notification is sent, even if it has not been canceled before that.

Bit to be bitwise-ored into the flags field that should be set if you want the LED on for this notification.

• To turn the LED off, pass 0 in the alpha channel for colorARGB or 0 for both ledOnMS and ledOffMS.
• To turn the LED on, pass 1 for ledOnMS and 0 for ledOffMS.
• To flash the LED, pass the number of milliseconds that it should be on and off to ledOnMS and ledOffMS.

Since hardware varies, you are not guaranteed that any of the values you pass are honored exactly. Use the system defaults (TODO) if possible because they will be set to values that work on any given hardware.

The alpha channel must be set for forward compatibility.

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_RING.

Parcelable.Creator that instantiates Notification objects

The audio stream type to use when playing the sound. Should be one of the STREAM_ constants from AudioManager.

The intent to execute when the expanded status entry is clicked. If this is an activity, it must include the FLAG_ACTIVITY_NEW_TASK flag, which requires that you take care of task management as described in the Tasks and Back Stack document. In particular, make sure to read the notification section Handling Notifications for the correct ways to launch an application from a notification.

The view that will represent this notification in the expanded status bar.

Specifies which values should be taken from the defaults.

To set, OR the desired from DEFAULT_SOUND, DEFAULT_VIBRATE, DEFAULT_LIGHTS. For all default values, use DEFAULT_ALL.

The intent to execute when the status entry is deleted by the user with the "Clear All Notifications" button. This probably shouldn't be launching an activity since several of those will be sent at the same time.

An intent to launch instead of posting the notification to the status bar.

The resource id of a drawable to use as the icon in the status bar. This is required; notifications with an invalid icon resource will not be shown.

If the icon in the status bar is to have more than one level, you can set this. Otherwise, leave it at its default value of 0.

The bitmap that may escape the bounds of the panel and bar.

The color of the led. The hardware will do its best approximation.

The number of milliseconds for the LED to be off while it's flashing. The hardware will do its best approximation.

The number of milliseconds for the LED to be on while it's flashing. The hardware will do its best approximation.

The number of events that this notification represents. For example, in a new mail notification, this could be the number of unread messages. This number is superimposed over the icon in the status bar. If the number is 0 or negative, it is not shown in the status bar.

The sound to play.

To play the default notification sound, see defaults.

Text to scroll across the screen when this item is added to the status bar on large and smaller devices.

This field is provided separately from the other ticker fields both for compatibility and to allow an application to choose different text for when the text scrolls in and when it is displayed all at once in conjunction with one or more icons.

The view to show as the ticker in the status bar when the notification is posted.

The pattern with which to vibrate.

To vibrate the default pattern, see defaults.

The timestamp for the notification. The icons and expanded views are sorted by this key.

Constructs a Notification object with everything set to 0. You might want to consider using Notification.Builder instead.

Constructs a Notification object with the information needed to have a status bar icon without the standard expanded view.

Unflatten the notification from a parcel.

Creates and returns a copy of this Object. The default implementation returns a so-called "shallow" copy: It creates a new instance of the same class and then copies the field values (including object references) from this instance to the new instance. A "deep" copy, in contrast, would also recursively clone nested objects. A subclass that needs to implement this kind of cloning should call super.clone() to create the new instance and then create deep copies of the nested, mutable objects.

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

Sets the contentView field to be a view with the standard "Latest Event" layout.

Uses the icon and when fields to set the icon and time fields in the view.

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

   getClass().getName() + '@' + Integer.toHexString(hashCode())

See Writing a useful toString method if you intend implementing your own toString method.

Flatten this notification from a parcel.