diff --git a/docs/html/wear/preview/api-overview.jd b/docs/html/wear/preview/api-overview.jd index 1fddab8b17086..58850570fb0d0 100644 --- a/docs/html/wear/preview/api-overview.jd +++ b/docs/html/wear/preview/api-overview.jd @@ -12,13 +12,6 @@ page.image=images/cards/card-n-apis_2x.png
In Wear 2.0, we’ve redesigned the key experiences on the watch to be even more
+ intuitive and provide users new ways to respond to messages. Some of the highlights
+ are below; for a complete list of changes, see
+ Notification Changes in Wear 2.0.
+
+
+
+
When a user taps on a notification that is bridged from the phone to +the watch or that lacks a {@code contentIntent}, the user will be +taken to the expanded view of that notification. When you +specify additional + content pages and actions for a notification, those are available to the user + within the expanded notification. Each expanded notification follows Material Design for Android Wear, so the user gets an app-like experience. +
+ + +If you have a chat messaging app, your notifications should use +{@code Notification.MessagingStyle}, which is new in Android 6.0. Wear 2.0 uses +the chat messages included in a +{@code MessagingStyle} + notification +(see {@code addMessage()}) to provide a rich chat app-like experience in the +expanded notification. +
+ + +Android Wear 2.0 introduces support for Smart Reply in +{@code MessagingStyle} + notifications. Smart Reply provides the user with contextually relevant, + touchable choices in the expanded notification and in + {@code RemoteInput}. +
+ +By enabling Smart Reply for your {@code MessagingStyle} notifications, you provide +users a fast (single tap), discreet (no speaking aloud), and reliable way to respond + to chat messages they receive. +
+ + +
+
+Wear 2.0 users can choose between various input options from +Remote Input. + These options include: +
++For messaging notifications with Smart Reply, the system-generated Smart Reply + appears within {@code RemoteInput} + above the developer-provided list of canned responses. + You can also use the + setChoices() + method in the {@code RemoteInput} API to enable users to select from a list + of canned responses. +
+ +By default, notifications are + +bridged (shared) from an app on a companion phone +to the watch. Since a phone app and a standalone watch app may be sources of the + same notifications, the Android Wear 2.0 Preview includes a Bridging mode feature. + Developers can begin planning to change the behavior of notifications with the + following: +
+ +For an example of how to use this feature, see +Bridging Mode for Notifications.
+ +Wear 2.0 extends the Android input method framework (IMF) to Android Wear. +This allows users to enter text on Wear using the system default IME or third party + IMEs. The Wear IME lets the user enter text via gesture typing as well as tapping + individual keys. The IMF APIs used for Wear devices are the same as other form + factors, though usage is slightly different due to limited screen real estate. +
+ +Wear provides user settings on the watch that let the user:
+To learn how to create an IME for Wear, see +Input Method Framework. +
+ +Standalone watches will enable Android Wear apps to work independently of phone - apps. This means your app can continue to offer full functionality even if the + apps. This means your app can continue to offer full functionality even if the paired phone is far away or turned off.
This delivery method is planned to change; the +
With standalone devices, the Multi-APK delivery method will be used. Developers will have the ability to release Android Wear apps independently of the corresponding phone apps. Please stay tuned for @@ -136,142 +250,23 @@ advertise a capability on the phone app and retrieve the capability on the watch
In Wear 2.0, we’ve redesigned the key experiences on the watch to be even more - intuitive and provide users new ways to respond to messages. Some of the highlights - are below; for a complete list of changes, see - Notification Changes in Wear 2.0. - -
When a user taps on a notification that is bridged from the phone to -the watch or that lacks a {@code contentIntent}, the user will be -taken to the expanded view of that notification. When you -specify additional - content pages and actions for a notification, those are available to the user - within the expanded notification. Each expanded notification follows Material Design for Android Wear, so the user gets an app-like experience. -
-
Figure 1.An expanded notification
- -If you have a chat messaging app, your notifications should use -{@code Notification.MessagingStyle}, which is new in Android 6.0. Wear 2.0 uses -the chat messages included in a -{@code MessagingStyle} - notification -(see {@code addMessage()}) to provide a rich chat app-like experience in the -expanded notification. -
- - -Android Wear 2.0 introduces support for Smart Reply in -{@code MessagingStyle} - notifications. Smart Reply provides the user with contextually relevant, - touchable choices in the expanded notification and in - {@code RemoteInput}. -
- -
Figure 2.Messaging Style notification with smart replies
- -By enabling Smart Reply for your {@code MessagingStyle} notifications, you provide -users a fast (single tap), discreet (no speaking aloud), and reliable way to respond - to chat messages they receive. -
- - -
-
-- Figure 5. Remote Input. -
- - -Wear 2.0 users can choose between various input options from -Remote Input. - These options include: -
--For messaging notifications with Smart Reply, the system-generated Smart Reply - appears within {@code RemoteInput} - above the developer-provided list of canned responses. - You can also use the - setChoices() - method in the {@code RemoteInput} API to enable users to select from a list - of canned responses. -
- -By default, notifications are - -bridged (shared) from an app on a companiosubl apin phone -to the watch. Since a phone app and a standalone watch app may be sources of the - same notifications, the Android Wear 2.0 Preview includes a Bridging mode feature. - Developers can begin planning to change the behavior of notifications with the - following: -
- -For an example of how to use this feature, see -Bridging Mode for Notifications.
- -Wear 2.0 extends the Android input method framework (IMF) to Android Wear. -This allows users to enter text on Wear using the system default IME or third party - IMEs. The Wear IME lets the user enter text via gesture typing as well as tapping - individual keys. The IMF APIs used for Wear devices are the same as other form - factors, though usage is slightly different due to limited screen real estate. -
- -Wear provides user settings on the watch that let the user:
-To learn how to create an IME for Wear, see -Input Method Framework. -
-The preview introduces powerful additions to the user interface, opening up exciting possibilities to developers. -A complication is any feature in a watch face that displays more than hours and +A complication is any feature in a watch face that displays more than hours and minutes. With the Complications API, watch faces can display extra information and separate apps can expose complication data. The navigation and action drawers provide users with new ways to interact with apps.
+
+
A complication is a feature of a watch face @@ -279,19 +274,11 @@ that displays more than hours and minutes. For example, a battery indicator is a complication. The Complications API is for both watch faces and data provider apps.
-
-
-- Figure 5. Watch face Complications. -
- -Watch faces can display extra information without needing code for getting the underlying data. Data providers can supply data to any watch face using the API.
-For examples of how to use this feature, +
For examples of how to use this feature, see Watch Face Complications.
@@ -309,13 +296,13 @@ see
+
Figure 1. Navigation and Action Drawers.
+