belongs to Maven artifact com.android.support:support-compat:28.0.0-alpha1
NotificationManagerCompat
public
final
class
NotificationManagerCompat
extends Object
java.lang.Object | |
↳ | android.support.v4.app.NotificationManagerCompat |
Compatibility library for NotificationManager with fallbacks for older platforms.
To use this class, call the static function from(Context)
to get a
NotificationManagerCompat
object, and then call one of its
methods to post or cancel notifications.
Summary
Constants | |
---|---|
String |
ACTION_BIND_SIDE_CHANNEL
Intent action to register for on a service to receive side channel notifications. |
String |
EXTRA_USE_SIDE_CHANNEL
Notification extras key: if set to true, the posted notification should use the side channel for delivery instead of using notification manager. |
int |
IMPORTANCE_DEFAULT
Default notification importance: shows everywhere, allowed to makes noise, but does not visually intrude. |
int |
IMPORTANCE_HIGH
Higher notification importance: shows everywhere, allowed to makes noise and peek. |
int |
IMPORTANCE_LOW
Low notification importance: shows everywhere, but is not intrusive. |
int |
IMPORTANCE_MAX
Highest notification importance: shows everywhere, allowed to makes noise, peek, and use full screen intents. |
int |
IMPORTANCE_MIN
Min notification importance: only shows in the shade, below the fold. |
int |
IMPORTANCE_NONE
A notification with no importance: shows nowhere, is blocked. |
int |
IMPORTANCE_UNSPECIFIED
Value signifying that the user has not expressed an importance. |
Public methods | |
---|---|
boolean
|
areNotificationsEnabled()
Returns whether notifications from the calling package are not blocked. |
void
|
cancel(String tag, int id)
Cancel a previously shown notification. |
void
|
cancel(int id)
Cancel a previously shown notification. |
void
|
cancelAll()
Cancel all previously shown notifications. |
static
NotificationManagerCompat
|
from(Context context)
Get a |
static
Set<String>
|
getEnabledListenerPackages(Context context)
Get the set of packages that have an enabled notification listener component within them. |
int
|
getImportance()
Returns the user specified importance for notifications from the calling package. |
void
|
notify(int id, Notification notification)
Post a notification to be shown in the status bar, stream, etc. |
void
|
notify(String tag, int id, Notification notification)
Post a notification to be shown in the status bar, stream, etc. |
Inherited methods | |
---|---|
From
class
java.lang.Object
|
Constants
ACTION_BIND_SIDE_CHANNEL
String ACTION_BIND_SIDE_CHANNEL
Intent action to register for on a service to receive side channel
notifications. The listening service must be in the same package as an enabled
NotificationListenerService
.
Constant Value: "android.support.BIND_NOTIFICATION_SIDE_CHANNEL"
EXTRA_USE_SIDE_CHANNEL
String EXTRA_USE_SIDE_CHANNEL
Notification extras key: if set to true, the posted notification should use the side channel for delivery instead of using notification manager.
Constant Value: "android.support.useSideChannel"
IMPORTANCE_DEFAULT
int IMPORTANCE_DEFAULT
Default notification importance: shows everywhere, allowed to makes noise, but does not visually intrude.
Constant Value: 3 (0x00000003)
IMPORTANCE_HIGH
int IMPORTANCE_HIGH
Higher notification importance: shows everywhere, allowed to makes noise and peek.
Constant Value: 4 (0x00000004)
IMPORTANCE_LOW
int IMPORTANCE_LOW
Low notification importance: shows everywhere, but is not intrusive.
Constant Value: 2 (0x00000002)
IMPORTANCE_MAX
int IMPORTANCE_MAX
Highest notification importance: shows everywhere, allowed to makes noise, peek, and use full screen intents.
Constant Value: 5 (0x00000005)
IMPORTANCE_MIN
int IMPORTANCE_MIN
Min notification importance: only shows in the shade, below the fold.
Constant Value: 1 (0x00000001)
IMPORTANCE_NONE
int IMPORTANCE_NONE
A notification with no importance: shows nowhere, is blocked.
Constant Value: 0 (0x00000000)
IMPORTANCE_UNSPECIFIED
int IMPORTANCE_UNSPECIFIED
Value signifying that the user has not expressed an importance. This value is for persisting preferences, and should never be associated with an actual notification.
Constant Value: -1000 (0xfffffc18)
Public methods
areNotificationsEnabled
boolean areNotificationsEnabled ()
Returns whether notifications from the calling package are not blocked.
Returns | |
---|---|
boolean |
cancel
void cancel (String tag, int id)
Cancel a previously shown notification.
Parameters | |
---|---|
tag |
String : the string identifier of the notification. |
id |
int : the ID of the notification
|
cancel
void cancel (int id)
Cancel a previously shown notification.
Parameters | |
---|---|
id |
int : the ID of the notification
|
from
NotificationManagerCompat from (Context context)
Get a NotificationManagerCompat
instance for a provided context.
Parameters | |
---|---|
context |
Context |
Returns | |
---|---|
NotificationManagerCompat |
getEnabledListenerPackages
Set<String> getEnabledListenerPackages (Context context)
Get the set of packages that have an enabled notification listener component within them.
Parameters | |
---|---|
context |
Context |
Returns | |
---|---|
Set<String> |
getImportance
int getImportance ()
Returns the user specified importance for notifications from the calling package.
Returns | |
---|---|
int |
An importance level, such as IMPORTANCE_DEFAULT .
|
notify
void notify (int id, Notification notification)
Post a notification to be shown in the status bar, stream, etc.
Parameters | |
---|---|
id |
int : the ID of the notification |
notification |
Notification : the notification to post to the system
|
notify
void notify (String tag, int id, Notification notification)
Post a notification to be shown in the status bar, stream, etc.
Parameters | |
---|---|
tag |
String : the string identifier for a notification. Can be null . |
id |
int : the ID of the notification. The pair (tag, id) must be unique within your app. |
notification |
Notification : the notification to post to the system
|
Annotations
Interfaces
- ActionBarDrawerToggle.Delegate
- ActionBarDrawerToggle.DelegateProvider
- ActivityCompat.OnRequestPermissionsResultCallback
- ActivityCompat.PermissionCompatDelegate
- FragmentManager.BackStackEntry
- FragmentManager.OnBackStackChangedListener
- LoaderManager.LoaderCallbacks
- NotificationCompat.Action.Extender
- NotificationCompat.Extender
- SharedElementCallback.OnSharedElementsReadyListener
- TaskStackBuilder.SupportParentable
Classes
- ActionBarDrawerToggle
- ActivityCompat
- ActivityManagerCompat
- ActivityOptionsCompat
- AlarmManagerCompat
- AppLaunchChecker
- AppOpsManagerCompat
- BundleCompat
- DialogFragment
- Fragment
- Fragment.SavedState
- FragmentActivity
- FragmentContainer
- FragmentController
- FragmentHostCallback
- FragmentManager
- FragmentManager.FragmentLifecycleCallbacks
- FragmentManagerNonConfig
- FragmentPagerAdapter
- FragmentStatePagerAdapter
- FragmentTabHost
- FragmentTransaction
- FrameMetricsAggregator
- JobIntentService
- ListFragment
- LoaderManager
- NavUtils
- NotificationCompat
- NotificationCompat.Action
- NotificationCompat.Action.Builder
- NotificationCompat.Action.WearableExtender
- NotificationCompat.BigPictureStyle
- NotificationCompat.BigTextStyle
- NotificationCompat.Builder
- NotificationCompat.CarExtender
- NotificationCompat.CarExtender.UnreadConversation
- NotificationCompat.CarExtender.UnreadConversation.Builder
- NotificationCompat.DecoratedCustomViewStyle
- NotificationCompat.InboxStyle
- NotificationCompat.MessagingStyle
- NotificationCompat.MessagingStyle.Message
- NotificationCompat.Style
- NotificationCompat.WearableExtender
- NotificationCompatExtras
- NotificationCompatSideChannelService
- NotificationManagerCompat
- RemoteInput
- RemoteInput.Builder
- ServiceCompat
- ShareCompat
- ShareCompat.IntentBuilder
- ShareCompat.IntentReader
- SharedElementCallback
- TaskStackBuilder
Exceptions