class BubbleMetadata : Parcelable
Encapsulates the information needed to display a notification as a bubble.
A bubble is used to display app content in a floating window over the existing foreground activity. A bubble has a collapsed state represented by an icon and an expanded state that displays an activity. These may be defined via Builder#Builder(PendingIntent, Icon)
or they may be defined via an existing shortcut using Builder#Builder(String)
.
Notifications with a valid and allowed bubble will display in collapsed state outside of the notification shade on unlocked devices. When a user interacts with the collapsed bubble, the bubble activity will be invoked and displayed.
Summary
Inherited constants |
From class Parcelable
Int |
CONTENTS_FILE_DESCRIPTOR
Descriptor bit used with describeContents() : indicates that the Parcelable object's flattened representation includes a file descriptor.
|
Int |
PARCELABLE_WRITE_RETURN_VALUE
Flag for use with writeToParcel : the object being written is a return value, that is the result of a function such as "Parcelable someFunction() ", "void someFunction(out Parcelable) ", or "void someFunction(inout Parcelable) ". Some implementations may want to release resources at this point.
|
|
Public methods |
Int |
|
Boolean |
|
PendingIntent? |
|
Int |
|
Int |
|
Icon? |
|
PendingIntent? |
|
String? |
|
Boolean |
Indicates whether the bubble should be visually suppressed from the bubble stack if the user is viewing the same content outside of the bubble.
|
Boolean |
Indicates whether the bubble is currently visually suppressed from the bubble stack.
|
Boolean |
Indicates whether the notification associated with the bubble is being visually suppressed from the notification shade.
|
Unit |
|
Public methods
describeContents
fun describeContents(): Int
getAutoExpandBubble
fun getAutoExpandBubble(): Boolean
Return |
Boolean |
whether this bubble should auto expand when it is posted. |
getDeleteIntent
fun getDeleteIntent(): PendingIntent?
Return |
PendingIntent? |
the pending intent to send when the bubble is dismissed by a user, if one exists. This value may be null . |
getDesiredHeight
fun getDesiredHeight(): Int
Return |
Int |
the ideal height, in DPs, for the floating window that app content defined by getIntent() for this bubble. A value of 0 indicates a desired height has not been set. |
getDesiredHeightResId
fun getDesiredHeightResId(): Int
Return |
Int |
the resId of ideal height for the floating window that app content defined by getIntent() for this bubble. A value of 0 indicates a res value has not been provided for the desired height. |
getIcon
fun getIcon(): Icon?
Return |
Icon? |
the icon that will be displayed for this bubble when it is collapsed, or null if the bubble is created via Builder#Builder(String) . |
getShortcutId
fun getShortcutId(): String?
isBubbleSuppressable
fun isBubbleSuppressable(): Boolean
Indicates whether the bubble should be visually suppressed from the bubble stack if the user is viewing the same content outside of the bubble. For example, the user has a bubble with Alice and then opens up the main app and navigates to Alice's page. To match the activity and the bubble notification, the bubble notification should have a locus id set that matches a locus id set on the activity.
Return |
Boolean |
whether this bubble should be suppressed when the same content is visible outside of the bubble. |
isBubbleSuppressed
fun isBubbleSuppressed(): Boolean
Indicates whether the bubble is currently visually suppressed from the bubble stack.
isNotificationSuppressed
fun isNotificationSuppressed(): Boolean
Indicates whether the notification associated with the bubble is being visually suppressed from the notification shade. When true
the notification is hidden, when false
the notification shows as normal.
Apps sending bubbles may set this flag so that the bubble is posted without the associated notification in the notification shade.
Generally the app should only set this flag if the user has performed an action to request or create a bubble, or if the user has seen the content in the notification and the notification is no longer relevant.
The system will update this flag with true
to hide the notification from the user once the bubble has been expanded.
Return |
Boolean |
whether this bubble should suppress the notification when it is posted. |
Properties