Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 61c69dd3 authored by Eric Schmidt's avatar Eric Schmidt Committed by android-build-merger
Browse files

Merge "docs: Updates to notifications for DP3" into mnc-io-docs am: f087f067 am: b6fb772c 

am: 3f88f2c5

* commit '3f88f2c5':
  docs: Updates to notifications for DP3

Change-Id: I6f446965c29666f9e38857509c631c0c6008be48
parents aac8b08d 3f88f2c5

docs/html/preview/api-overview.jd

+8 −1
Original line number Diff line number Diff line
@@ -113,6 +113,13 @@ use. Some of the changes include:</p> 
    take advantage of the new templates with minimal adjustments in their code.

  </li>



  <li>

    <strong>Message style customization</strong>: You can customize more of the

    user interface labels associated with your notifications using the

    <code>MessageStyle</code> class. You can configure the message, conversation

    title, and content view.

  </li>



  <li>

    <strong>Bundled notifications</strong>: The system can group messages

    together, for example by message topic, and display the group. A user can

docs/html/preview/features/notification-updates.jd

+32 −1
Original line number Diff line number Diff line
@@ -16,6 +16,7 @@ trainingnavtop=true 
  <li><a href="#direct">Direct Reply</a></li>

  <li><a href="#bundle">Bundled Notifications</a></li>

  <li><a href="#custom">Custom Views</a></li>

  <li><a href="#style">Message Style</a></li>

</ol>



</div>
@@ -233,6 +234,12 @@ Builder.setGroup()} method to bundle similar notifications.</p> 
  group.

</p>



<p class="note">

  <strong>Note:</strong> If the same app sends four or more notifications

  and does not specify a grouping, the

  system automatically groups them together.

</p>



<p>To learn how to add notifications to a group, see

<a href="{@docRoot}training/wearables/notifications/stacks.html#AddGroup">Add

Each Notification to a Group</a>.</p>
@@ -348,7 +355,7 @@ the desired custom view style.</p> 
{@code DecoratedCustomViewStyle()} method.</p>



<pre>

Notification noti = new Notification.Builder()

Notification notification = new Notification.Builder()

           .setSmallIcon(R.drawable.ic_stat_player)

           .setLargeIcon(albumArtBitmap))

           .setCustomContentView(contentView);
@@ -356,3 +363,27 @@ Notification noti = new Notification.Builder() 
           .build();



</pre>



<h2 id="style">Message Style</h2>

<p>

  Android N introduces a new API for customizing the style of a notification.

  Using the <code>MessageStyle</code> class, you can change several of the

  labels displayed on the notification, including the conversation title,

  additional messages, and the content view for the notification.

</p>



<p>

  The following code snippet demonstrates how to customize a notification's

  style using the <code>MessageStyle</code> class.

</p>



<pre>

  Notification notification = new Notification.Builder()

             .setStyle(new Notification.MessagingStyle("Me")

             .setConversationTitle("Team lunch")

             .addMessage("Hi", timestamp1, null) // Pass in null for user.

             .addMessage("What's up?", timestamp2, "Coworker")

             .addMessage("Not much", timestamp3, null)

             .addMessage("How about lunch?", timestamp4, "Coworker")

             .setAllow());

</pre>
 
 No newline at end of file