Action

open class Action

kotlin.Any
↳	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
	`Builder` Builder class for `Action` objects.
abstract	`Extender` Extender interface for use with `Builder#extend`.
	`SemanticAction` Provides meaning to an `Action` that hints at what the associated `PendingIntent` will do.
	`WearableExtender` Wearable extender for notification actions.

Constants
static Int	`SEMANTIC_ACTION_ARCHIVE` `SemanticAction`: Archive the content associated with the notification.
static Int	`SEMANTIC_ACTION_CALL` `SemanticAction`: Call a contact, group, etc.
static Int	`SEMANTIC_ACTION_DELETE` `SemanticAction`: Delete the content associated with the notification.
static Int	`SEMANTIC_ACTION_MARK_AS_READ` `SemanticAction`: Mark content as read.
static Int	`SEMANTIC_ACTION_MARK_AS_UNREAD` `SemanticAction`: Mark content as unread.
static Int	`SEMANTIC_ACTION_MUTE` `SemanticAction`: Mute the content associated with the notification.
static Int	`SEMANTIC_ACTION_NONE` `SemanticAction`: No semantic action defined.
static Int	`SEMANTIC_ACTION_REPLY` `SemanticAction`: Reply to a conversation, chat, group, or wherever replies may be appropriate.
static Int	`SEMANTIC_ACTION_THUMBS_DOWN` `SemanticAction`: Mark content with a thumbs down.
static Int	`SEMANTIC_ACTION_THUMBS_UP` `SemanticAction`: Mark content with a thumbs up.
static Int	`SEMANTIC_ACTION_UNMUTE` `SemanticAction`: Unmute the content associated with the notification.

Public constructors
`<init>(icon: Int, title: CharSequence!, intent: PendingIntent!)`

Public methods
open Int	`getIcon()`
open Array<RemoteInput!>!	`getRemoteInputs()` Get the list of inputs to be collected from the user when this action is sent.
open Bundle!	`getExtras()` Get additional metadata carried around with this Action.
open Boolean	`getShowsUserInterface()` Return whether or not triggering this `Action`'s `PendingIntent` will open a user interface.
open PendingIntent!	`getActionIntent()`
open Boolean	`getAllowGeneratedReplies()` Return whether the platform should automatically generate possible replies for this `Action`
open Array<RemoteInput!>!	`getDataOnlyRemoteInputs()` Get the list of inputs to be collected from the user that ONLY accept data when this action is sent.
open CharSequence!	`getTitle()`
open Int	`getSemanticAction()` Returns the `SemanticAction` associated with this `Action`.

Properties
PendingIntent!	`actionIntent` Intent to send when the user invokes this action.
Int	`icon` Small icon representing the action.
CharSequence!	`title` Title of the action.

Constants

SEMANTIC_ACTION_ARCHIVE

static val SEMANTIC_ACTION_ARCHIVE: Int

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

Value: 5

SEMANTIC_ACTION_CALL

static val SEMANTIC_ACTION_CALL: Int

SemanticAction: Call a contact, group, etc.

Value: 10

SEMANTIC_ACTION_DELETE

static val SEMANTIC_ACTION_DELETE: Int

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

Value: 4

SEMANTIC_ACTION_MARK_AS_READ

static val SEMANTIC_ACTION_MARK_AS_READ: Int

SemanticAction: Mark content as read.

Value: 2

SEMANTIC_ACTION_MARK_AS_UNREAD

static val SEMANTIC_ACTION_MARK_AS_UNREAD: Int

SemanticAction: Mark content as unread.

Value: 3

SEMANTIC_ACTION_MUTE

static val SEMANTIC_ACTION_MUTE: Int

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

Value: 6

SEMANTIC_ACTION_NONE

static val SEMANTIC_ACTION_NONE: Int

SemanticAction: No semantic action defined.

Value: 0

SEMANTIC_ACTION_REPLY

static val SEMANTIC_ACTION_REPLY: Int

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

Value: 1

SEMANTIC_ACTION_THUMBS_DOWN

static val SEMANTIC_ACTION_THUMBS_DOWN: Int

SemanticAction: Mark content with a thumbs down.

Value: 9

SEMANTIC_ACTION_THUMBS_UP

static val SEMANTIC_ACTION_THUMBS_UP: Int

SemanticAction: Mark content with a thumbs up.

Value: 8

SEMANTIC_ACTION_UNMUTE

static val SEMANTIC_ACTION_UNMUTE: Int

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

Value: 7

Public constructors

<init>

Action(icon: Int, title: CharSequence!, intent: PendingIntent!)

Public methods

getIcon

open fun getIcon(): Int

getRemoteInputs

open fun getRemoteInputs(): Array<RemoteInput!>!

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.

getExtras

open fun getExtras(): Bundle!

Get additional metadata carried around with this Action.

getShowsUserInterface

open fun getShowsUserInterface(): Boolean

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

getActionIntent

open fun getActionIntent(): PendingIntent!

getAllowGeneratedReplies

open fun getAllowGeneratedReplies(): Boolean

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

getDataOnlyRemoteInputs

open fun getDataOnlyRemoteInputs(): Array<RemoteInput!>!

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.

getTitle

open fun getTitle(): CharSequence!

getSemanticAction

open fun getSemanticAction(): Int

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

See Also

SemanticAction

Properties

actionIntent

var actionIntent: PendingIntent!

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

var icon: Int

Small icon representing the action.

title

var title: CharSequence!

Title of the action.