public
static
class
Notification.MessagingStyle
extends Notification.Style
java.lang.Object | ||
↳ | android.app.Notification.Style | |
↳ | android.app.Notification.MessagingStyle |
Helper class for generating large-format notifications that include multiple back-and-forth
messages of varying types between any number of people.
If the platform does not provide large-format notifications, this method has no effect. The
user will always see the normal notification view.
This class is a "rebuilder": It attaches to a Builder object and modifies its behavior, like
so:
Notification noti = new Notification.Builder() .setContentTitle("2 new messages wtih " + sender.toString()) .setContentText(subject) .setSmallIcon(R.drawable.new_message) .setLargeIcon(aBitmap) .setStyle(new Notification.MessagingStyle(resources.getString(R.string.reply_name)) .addMessage(messages[0].getText(), messages[0].getTime(), messages[0].getSender()) .addMessage(messages[1].getText(), messages[1].getTime(), messages[1].getSender())) .build();
Nested classes | |
---|---|
class |
Notification.MessagingStyle.Message
|
Constants | |
---|---|
int |
MAXIMUM_RETAINED_MESSAGES
The maximum number of messages that will be retained in the Notification itself (the number displayed is up to the platform). |
Inherited fields |
---|
From
class
android.app.Notification.Style
|
Public constructors | |
---|---|
Notification.MessagingStyle(CharSequence userDisplayName)
|
Public methods | |
---|---|
Notification.MessagingStyle
|
addMessage(CharSequence text, long timestamp, CharSequence sender)
Adds a message for display by this notification. |
Notification.MessagingStyle
|
addMessage(Notification.MessagingStyle.Message message)
Adds a |
CharSequence
|
getConversationTitle()
Return the title to be displayed on this conversation. |
List<Notification.MessagingStyle.Message>
|
getMessages()
Gets the list of |
CharSequence
|
getUserDisplayName()
Returns the name to be displayed for any replies sent by the user |
Notification.MessagingStyle
|
setConversationTitle(CharSequence conversationTitle)
Sets the title to be displayed on this conversation. |
Inherited methods | |
---|---|
From
class
android.app.Notification.Style
| |
From
class
java.lang.Object
|
int MAXIMUM_RETAINED_MESSAGES
The maximum number of messages that will be retained in the Notification itself (the number displayed is up to the platform).
Constant Value: 25 (0x00000019)
Notification.MessagingStyle (CharSequence userDisplayName)
Parameters | |
---|---|
userDisplayName |
CharSequence :
the name to be displayed for any replies sent by the user before the
posting app reposts the notification with those messages after they've been actually
sent and in previous messages sent by the user added in
addMessage(Notification.MessagingStyle.Message)
|
Notification.MessagingStyle addMessage (CharSequence text, long timestamp, CharSequence sender)
Adds a message for display by this notification. Convenience call for a simple
Notification.MessagingStyle.Message
in addMessage(Notification.MessagingStyle.Message)
.
Parameters | |
---|---|
text |
CharSequence :
A CharSequence to be displayed as the message content |
timestamp |
long :
Time at which the message arrived |
sender |
CharSequence :
A CharSequence to be used for displaying the name of the
sender. Should be null for messages by the current user, in which case
the platform will insert getUserDisplayName() .
Should be unique amongst all individuals in the conversation, and should be
consistent during re-posts of the notification. |
Returns | |
---|---|
Notification.MessagingStyle |
this object for method chaining |
Notification.MessagingStyle addMessage (Notification.MessagingStyle.Message message)
Adds a Notification.MessagingStyle.Message
for display in this notification.
Parameters | |
---|---|
message |
Notification.MessagingStyle.Message :
The Notification.MessagingStyle.Message to be displayed |
Returns | |
---|---|
Notification.MessagingStyle |
this object for method chaining |
CharSequence getConversationTitle ()
Return the title to be displayed on this conversation. Can be null
and
should be for one-on-one conversations
Returns | |
---|---|
CharSequence |
List<Notification.MessagingStyle.Message> getMessages ()
Gets the list of Message
objects that represent the notification
Returns | |
---|---|
List<Notification.MessagingStyle.Message> |
CharSequence getUserDisplayName ()
Returns the name to be displayed for any replies sent by the user
Returns | |
---|---|
CharSequence |
Notification.MessagingStyle setConversationTitle (CharSequence conversationTitle)
Sets the title to be displayed on this conversation. This should only be used for group messaging and left unset for one-on-one conversations.
Returns | |
---|---|
Notification.MessagingStyle |
this object for method chaining. |