Ya está disponible la segunda Vista previa para desarrolladores de Android 11; pruébala y comparte tus comentarios.

NotificationCompat.Action

public static class NotificationCompat.Action
extends Object

java.lang.Object
   ↳ androidx.core.app.NotificationCompat.Action

Structure to encapsulate a named action that can be shown as part of this notification. It must include an icon, a label, and a PendingIntent to be fired when the action is selected by the user. Action buttons won't appear on platforms prior to Android 4.1.

Apps should use NotificationCompat.Builder.addAction(int, CharSequence, PendingIntent) or NotificationCompat.Builder.addAction(NotificationCompat.Action) to attach actions.

Summary

Nested classes

class NotificationCompat.Action.Builder

Builder class for NotificationCompat.Action objects. 

interface NotificationCompat.Action.Extender

Extender interface for use with NotificationCompat.Builder.extend(NotificationCompat.Extender). 

@interface NotificationCompat.Action.SemanticAction

Provides meaning to an NotificationCompat.Action that hints at what the associated PendingIntent will do. 

class NotificationCompat.Action.WearableExtender

Wearable extender for notification actions. 

Constants

int SEMANTIC_ACTION_ARCHIVE

NotificationCompat.Action.SemanticAction: Archive the content associated with the notification.

int SEMANTIC_ACTION_CALL

NotificationCompat.Action.SemanticAction: Call a contact, group, etc.

int SEMANTIC_ACTION_DELETE

NotificationCompat.Action.SemanticAction: Delete the content associated with the notification.

int SEMANTIC_ACTION_MARK_AS_READ

NotificationCompat.Action.SemanticAction: Mark content as read.

int SEMANTIC_ACTION_MARK_AS_UNREAD

NotificationCompat.Action.SemanticAction: Mark content as unread.

int SEMANTIC_ACTION_MUTE

NotificationCompat.Action.SemanticAction: Mute the content associated with the notification.

int SEMANTIC_ACTION_NONE

NotificationCompat.Action.SemanticAction: No semantic action defined.

int SEMANTIC_ACTION_REPLY

NotificationCompat.Action.SemanticAction: Reply to a conversation, chat, group, or wherever replies may be appropriate.

int SEMANTIC_ACTION_THUMBS_DOWN

NotificationCompat.Action.SemanticAction: Mark content with a thumbs down.

int SEMANTIC_ACTION_THUMBS_UP

NotificationCompat.Action.SemanticAction: Mark content with a thumbs up.

int SEMANTIC_ACTION_UNMUTE

NotificationCompat.Action.SemanticAction: Unmute the content associated with the notification.

Fields

public PendingIntent actionIntent

Intent to send when the user invokes this action.

public int icon

This field is deprecated. Use getIconCompat() instead.

public CharSequence title

Title of the action.

Public constructors

NotificationCompat.Action(int icon, CharSequence title, PendingIntent intent)
NotificationCompat.Action(IconCompat icon, CharSequence title, PendingIntent intent)

Note: For devices running an Android version strictly lower than API level 23 this constructor only supports resource-ID based IconCompat objects.

Public methods

PendingIntent getActionIntent()
boolean getAllowGeneratedReplies()

Return whether the platform should automatically generate possible replies for this NotificationCompat.Action

RemoteInput[] getDataOnlyRemoteInputs()

Get the list of inputs to be collected from the user that ONLY accept data when this action is sent.

Bundle getExtras()

Get additional metadata carried around with this Action.

int getIcon()

This method is deprecated. use getIconCompat() instead.

IconCompat getIconCompat()

Return the icon associated with this Action.

RemoteInput[] getRemoteInputs()

Get the list of inputs to be collected from the user when this action is sent.

int getSemanticAction()

Returns the NotificationCompat.Action.SemanticAction associated with this NotificationCompat.Action.

boolean getShowsUserInterface()

Return whether or not triggering this NotificationCompat.Action's PendingIntent will open a user interface.

CharSequence getTitle()
boolean isContextual()

Returns whether this is a contextual Action, i.e.

Inherited methods

Constants

SEMANTIC_ACTION_ARCHIVE

public static final int SEMANTIC_ACTION_ARCHIVE

NotificationCompat.Action.SemanticAction: Archive the content associated with the notification. This could mean archiving an email, message, etc.

Constant Value: 5 (0x00000005)

SEMANTIC_ACTION_CALL

public static final int SEMANTIC_ACTION_CALL

NotificationCompat.Action.SemanticAction: Call a contact, group, etc.

Constant Value: 10 (0x0000000a)

SEMANTIC_ACTION_DELETE

public static final int SEMANTIC_ACTION_DELETE

NotificationCompat.Action.SemanticAction: Delete the content associated with the notification. This could mean deleting an email, message, etc.

Constant Value: 4 (0x00000004)

SEMANTIC_ACTION_MARK_AS_READ

public static final int SEMANTIC_ACTION_MARK_AS_READ

NotificationCompat.Action.SemanticAction: Mark content as read.

Constant Value: 2 (0x00000002)

SEMANTIC_ACTION_MARK_AS_UNREAD

public static final int SEMANTIC_ACTION_MARK_AS_UNREAD

NotificationCompat.Action.SemanticAction: Mark content as unread.

Constant Value: 3 (0x00000003)

SEMANTIC_ACTION_MUTE

public static final int SEMANTIC_ACTION_MUTE

NotificationCompat.Action.SemanticAction: Mute the content associated with the notification. This could mean silencing a conversation or currently playing media.

Constant Value: 6 (0x00000006)

SEMANTIC_ACTION_NONE

public static final int SEMANTIC_ACTION_NONE

NotificationCompat.Action.SemanticAction: No semantic action defined.

Constant Value: 0 (0x00000000)

SEMANTIC_ACTION_REPLY

public static final int SEMANTIC_ACTION_REPLY

NotificationCompat.Action.SemanticAction: Reply to a conversation, chat, group, or wherever replies may be appropriate.

Constant Value: 1 (0x00000001)

SEMANTIC_ACTION_THUMBS_DOWN

public static final int SEMANTIC_ACTION_THUMBS_DOWN

NotificationCompat.Action.SemanticAction: Mark content with a thumbs down.

Constant Value: 9 (0x00000009)

SEMANTIC_ACTION_THUMBS_UP

public static final int SEMANTIC_ACTION_THUMBS_UP

NotificationCompat.Action.SemanticAction: Mark content with a thumbs up.

Constant Value: 8 (0x00000008)

SEMANTIC_ACTION_UNMUTE

public static final int SEMANTIC_ACTION_UNMUTE

NotificationCompat.Action.SemanticAction: Unmute the content associated with the notification. This could mean un-silencing a conversation or currently playing media.

Constant Value: 7 (0x00000007)

Fields

actionIntent

public PendingIntent actionIntent

Intent to send when the user invokes this action. May be null, in which case the action may be rendered in a disabled presentation.

icon

public int icon

This field is deprecated.
Use getIconCompat() instead.

Small icon representing the action.

title

public CharSequence title

Title of the action.

Public constructors

NotificationCompat.Action

public NotificationCompat.Action (int icon, 
                CharSequence title, 
                PendingIntent intent)

Parameters
icon int

title CharSequence

intent PendingIntent

NotificationCompat.Action

public NotificationCompat.Action (IconCompat icon, 
                CharSequence title, 
                PendingIntent intent)

Note: For devices running an Android version strictly lower than API level 23 this constructor only supports resource-ID based IconCompat objects.

Parameters
icon IconCompat

title CharSequence

intent PendingIntent

Public methods

getActionIntent

public PendingIntent getActionIntent ()

Returns
PendingIntent

getAllowGeneratedReplies

public boolean getAllowGeneratedReplies ()

Return whether the platform should automatically generate possible replies for this NotificationCompat.Action

Returns
boolean

getDataOnlyRemoteInputs

public RemoteInput[] getDataOnlyRemoteInputs ()

Get the list of inputs to be collected from the user that ONLY accept data when this action is sent. These remote inputs are guaranteed to return true on a call to RemoteInput.isDataOnly().

May return null if no data-only remote inputs were added.

This method exists so that legacy RemoteInput collectors that pre-date the addition of non-textual RemoteInputs do not access these remote inputs.

Returns
RemoteInput[]

getExtras

public Bundle getExtras ()

Get additional metadata carried around with this Action.

Returns
Bundle

getIcon

public int getIcon ()

This method is deprecated.
use getIconCompat() instead.

Returns
int

getIconCompat

public IconCompat getIconCompat ()

Return the icon associated with this Action.

Returns
IconCompat

getRemoteInputs

public RemoteInput[] getRemoteInputs ()

Get the list of inputs to be collected from the user when this action is sent. May return null if no remote inputs were added. Only returns inputs which accept a text input. For inputs which only accept data use getDataOnlyRemoteInputs().

Returns
RemoteInput[]

getSemanticAction

public int getSemanticAction ()

Returns the NotificationCompat.Action.SemanticAction associated with this NotificationCompat.Action. A NotificationCompat.Action.SemanticAction denotes what an NotificationCompat.Action's PendingIntent will do (eg. reply, mark as read, delete, etc).

Returns
int

getShowsUserInterface

public boolean getShowsUserInterface ()

Return whether or not triggering this NotificationCompat.Action's PendingIntent will open a user interface.

Returns
boolean

getTitle

public CharSequence getTitle ()

Returns
CharSequence

isContextual

public boolean isContextual ()

Returns whether this is a contextual Action, i.e. whether the action is dependent on the notification message body. An example of a contextual action could be an action opening a map application with an address shown in the notification.

Returns
boolean