docs: Added emoji section to api overview.
Bug: 27920740
Change-Id: Ib3c31c83ffd45d564ea0a6164f2d91df11c3f213
diff --git a/docs/html/preview/api-overview.jd b/docs/html/preview/api-overview.jd
index 4a7b879..9590ff6 100644
--- a/docs/html/preview/api-overview.jd
+++ b/docs/html/preview/api-overview.jd
@@ -38,6 +38,7 @@
<li><a href="#launcher_shortcuts">Launcher shortcuts</a></li>
<li><a href="#print_svc">Print service enhancements</a></li>
<li><a href="#virtual_files">Virtual Files</a></li>
+ <li><a href="#emoji">New Emojis</a></li>
</ol>
</div>
</div>
@@ -936,4 +937,42 @@
For more information about accessing user files, see the
<a href="{@docRoot}guide/topics/providers/document-provider.html">Storage
Access Frameworks guide</a>.
-</p>
\ No newline at end of file
+</p>
+
+<h2 id="emoji">New Emojis</h2>
+
+<p>
+ Android N introduces new emojis, including skin tone emojis, support
+ for variation
+ selectors, and other improvements. For a good user experience, observe the
+ following guidelines for using the new emojis and emoji features in your apps.
+</p>
+
+<ul>
+ <li>
+ <strong>New emojis</strong>: To check which emojis are present in the
+ system font, use the {@link android.graphics.Paint#hasGlyph(String)} method
+ and the dynamic layout in the emoji picker to place the glyphs.
+ </li>
+ <li>
+ <strong>Variation selectors</strong>: Variation selectors allow certain
+ emojis to be represented in color or in text presentation, which is used in
+ documents. For mobile devices, emojis should use their color representation.
+ To determine whether an emoji has a variation, use the variation selector.
+ You can view the complete list of characters with variations in the
+ <em>emoji variation sequences</em> section of the
+ <a href="http://www.unicode.org/Public/9.0.0/ucd/StandardizedVariants-9.0.0d1.txt">
+ Unicode documentation on variations</a>.
+ </li>
+ <li>
+ <strong>Skin tone modifiers</strong>: In Android N, users can modify the
+ rendered skin tone of emojis. This allows users to customize the presentation
+ of emojis to their preference. Keyboard apps should provide visual
+ indications for emojis that have multiple skin tones and should allow users to
+ select the skin tone that they prefer. To determine which system emojis have
+ skin tone modifiers, use the {@link android.graphics.Paint#hasGlyph(String)}
+ method. You can determine which emojis use skin tones by reading the
+ <a href="http://unicode.org/emoji/charts/full-emoji-list.html">
+ Unicode documentation</a>.
+ </li>
+</ul>
\ No newline at end of file