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

docs: Updates to Preview Notifications doc

Browse Source 
Per SME's request, updated the description of how bundled
notifications are displayed.

See first comment for doc stage location.

bug: 26645465
Change-Id: I58a61a1f02a91e6bb315b8223a32de07a3768a01
This commit is contained in:
Andrew Solovay
2016-03-07 16:19:56 -08:00
parent 546248178e
commit 1641db0bdc
1 changed files with 20 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
docs/html/preview/features/notification-updates.jd
View File

@@ -170,11 +170,10 @@ For interactive apps (like chats), provide more context in the notification itse
so that the user can respond appropriately.
When the user responds via {@link android.support.v4.app.RemoteInput},
include the text in the reply history with the {@code setRemoteInputHistory()}
method.
method.</p>
<img id="fig-chat-history" src=
"{@docRoot}preview/images/inline-reply-sent.png">
<img id="fig-chat-history" src="{@docRoot}preview/images/inline-reply-sent.png">
<p class="img-caption">
<strong>Figure 3.</strong> Screenshot of chat history in the notification
shade.
@@ -193,12 +192,12 @@ Builder.setGroup()} method to bundle similar notifications.</p>
<p>
A notification group imposes a hierarchy on the notifications comprising it.
At the top of that hierarchy is a parent notification that displays the first
line of the first notification in the group. The user can progressively
At the top of that hierarchy is a parent notification that displays summary
information for the group. The user can progressively
expand the notification group, and the system shows more information as the
user drills deeper. When the user expands the bundle, the system reveals the
first line of each notification within the bundle; when the user expands one
of those notifications, the system reveals its entire content.
user drills deeper. When the user expands the bundle, the system reveals more
information for all its child notifications; when the user
expands one of those notifications, the system reveals its entire content.
</p>
<img id="fig-bundles" src="{@docRoot}preview/images/bundles.png">
@@ -242,15 +241,20 @@ received emails.</p>
single-line text items.</p>
<h3 id ="post">Displaying bundled notifications</h3>
<p>When a group only has a single child notification, the app should in general
not post a notification group, but instead post that notification individually.
Only if it accumulates more than one child should it display the notifications
in a group.</p>
<p>Similarly, when a user swipes away children of an expanded
notification group, the app should remove the group as soon as there is only a
single child left. It should then convert the child into a normal, single
notification.</p>
<p>
The app should always post a group summary, even if the group contains just a
single child. The system will suppress the summary and directly display the
child notification if it only contains a single notification. This ensures
that the system can provide a consistent experience when the user swipes away
children of a group.
</p>
<p class="note">
<strong>Note:</strong> This version of the N Developer Preview does not yet
suppress the summary for notification groups containing a single child. This
functionality will be added in a later version of the N Developer Preview.
</p>
<h3>Peeking notifications</h3>