Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Add guidance on conversation notifications" into rvc-dev

Browse Source
This commit is contained in:
Julia Reynolds
2020-04-13 12:28:28 +00:00
committed by Android (Google) Code Review
parent 83c4af69d0 7aca3b64aa
commit f5590f558d
1 changed files with 29 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
core/java/android/app/Notification.java
View File

@@ -3594,20 +3594,42 @@ public class Notification implements Parcelable
} }
/** /**
* If this notification is duplicative of a Launcher shortcut, sets the * From Android 11, messaging notifications (those that use {@link MessagingStyle}) that
* {@link ShortcutInfo#getId() id} of the shortcut, in case the Launcher wants to hide * use this method to link to a published long-lived sharing shortcut may appear in a
* the shortcut. * dedicated Conversation section of the shade and may show configuration options that
* * are unique to conversations. This behavior should be reserved for person to person(s)
* This field will be ignored by Launchers that don't support badging, don't show * conversations where there is a likely social obligation for an individual to respond.
* notification content, or don't show {@link android.content.pm.ShortcutManager shortcuts}. * <p>
* For example, the following are some examples of notifications that belong in the
* conversation space:
* <ul>
* <li>1:1 conversations between two individuals</li>
* <li>Group conversations between individuals where everyone can contribute</li>
* </ul>
* And the following are some examples of notifications that do not belong in the
* conversation space:
* <ul>
* <li>Advertisements from a bot (even if personal and contextualized)</li>
* <li>Engagement notifications from a bot</li>
* <li>Directional conversations where there is an active speaker and many passive
* individuals</li>
* <li>Stream / posting updates from other individuals</li>
* </ul>
* </p>
* *
* <p>
* Additionally, this method can be used for all types of notifications to mark this
* notification as duplicative of a Launcher shortcut. Launchers that show badges or
* notification content may then suppress the shortcut in favor of the content of this
* notification.
* <p>
* If this notification has {@link BubbleMetadata} attached that was created with * If this notification has {@link BubbleMetadata} attached that was created with
* a shortcutId a check will be performed to ensure the shortcutId supplied to bubble * a shortcutId a check will be performed to ensure the shortcutId supplied to bubble
* metadata matches the shortcutId set here, if one was set. If the shortcutId's were * metadata matches the shortcutId set here, if one was set. If the shortcutId's were
* specified but do not match, an exception is thrown. * specified but do not match, an exception is thrown.
* *
* @param shortcutId the {@link ShortcutInfo#getId() id} of the shortcut this notification * @param shortcutId the {@link ShortcutInfo#getId() id} of the shortcut this notification
* supersedes * is linked to
* *
* @see Notification.BubbleMetadata.Builder#Builder(String) * @see Notification.BubbleMetadata.Builder#Builder(String)
*/ */