diff --git a/docs/html/design/media/wear/ambient_list.png b/docs/html/design/media/wear/ambient_list.png new file mode 100644 index 0000000000000..7425fb92c41de Binary files /dev/null and b/docs/html/design/media/wear/ambient_list.png differ diff --git a/docs/html/design/media/wear/ambient_list@2x.png b/docs/html/design/media/wear/ambient_list@2x.png new file mode 100644 index 0000000000000..fe46575b5832a Binary files /dev/null and b/docs/html/design/media/wear/ambient_list@2x.png differ diff --git a/docs/html/design/media/wear/ambient_run.png b/docs/html/design/media/wear/ambient_run.png new file mode 100644 index 0000000000000..7140f461d7378 Binary files /dev/null and b/docs/html/design/media/wear/ambient_run.png differ diff --git a/docs/html/design/media/wear/ambient_run@2x.png b/docs/html/design/media/wear/ambient_run@2x.png new file mode 100644 index 0000000000000..8ae41cc1406c0 Binary files /dev/null and b/docs/html/design/media/wear/ambient_run@2x.png differ diff --git a/docs/html/design/media/wear/interactive_list.png b/docs/html/design/media/wear/interactive_list.png new file mode 100644 index 0000000000000..970d33a87c4bb Binary files /dev/null and b/docs/html/design/media/wear/interactive_list.png differ diff --git a/docs/html/design/media/wear/interactive_list@2x.png b/docs/html/design/media/wear/interactive_list@2x.png new file mode 100644 index 0000000000000..9d17456f31bed Binary files /dev/null and b/docs/html/design/media/wear/interactive_list@2x.png differ diff --git a/docs/html/design/media/wear/interactive_run.png b/docs/html/design/media/wear/interactive_run.png new file mode 100644 index 0000000000000..50b9a80e38749 Binary files /dev/null and b/docs/html/design/media/wear/interactive_run.png differ diff --git a/docs/html/design/media/wear/interactive_run@2x.png b/docs/html/design/media/wear/interactive_run@2x.png new file mode 100644 index 0000000000000..5911367c54fcf Binary files /dev/null and b/docs/html/design/media/wear/interactive_run@2x.png differ diff --git a/docs/html/design/wear/structure.jd b/docs/html/design/wear/structure.jd index 95d5c1aeeccae..c1d9ef9dc9252 100644 --- a/docs/html/design/wear/structure.jd +++ b/docs/html/design/wear/structure.jd @@ -22,14 +22,24 @@ margin: 0 10px 20px 20px; @@ -160,7 +170,77 @@ href="#2DPicker">2D picker is always available.

Manually exiting

-

Even with logical exit points like these, some cases may exist where the user may want to immediately exit. This may be common in apps that are used for a longer while. In all cases, you should treat long-press as the user's intent to exit, using +

Even with logical exit points like these, some cases may exist where the user may want to +immediately exit. This may be common in apps that are used for a longer while. In all cases, you +should treat long-press as the user's intent to exit, using DismissOverlayView.

+

Keeping the app always-on

+ + +
+

Developer Docs

+

Keeping Your App Always-On

+
+
+ +

An Android Wear device has two modes:

+ +
+
Interactive mode
+
A full-color mode where the user can interact with your app.
+
Ambient mode
+
A low-power mode where the screen is rendered in black and white, with +minimal grayscale graphics.
+
+ +

Interactive activities provide real-time information and feedback to the user, but it can quickly +drain the device's battery. To reduce battery usage and still present useful information, apps can +transition into an ambient mode called always-on. +

+ +

Your app can display dynamic data on the device, even when the app is in ambient mode. This +approach is useful if your app displays information that is continuously updated, like a running +tracker app, or when it presents information the user needs for reference, like a grocery app.

+ +

Typical user experiences with apps that switch into ambient mode on Android Wear look like +this:

+ + + + + +

When the app switches to ambient mode, remove all elements that invite +touch or indicate the elements are disabled. In addition, consider showing the current time.

+ +

Update frequency

+ +

You should only update the display once per minute, to preserve battery life of the wearable +device. You can update the display every 10 seconds, but make sure you only update when absolutely +necessary. Every update depletes the device's battery. +

+ +

Interactive elements

+ +

Don’t present any buttons or other interactive elements when the app is in ambient mode. This +approach could mislead the user into thinking the app is in interactive mode.

+ +

Colors and brightness

+ +

Use grayscale colors to help signal that the user must wake up the device before they can +interact with it. Also note that any pixel that is not black will be noticeably bright for users in +dimly lit rooms. We strongly recommend keeping the background black whenever possible.

+ +

Privacy

+ +

Consider the user’s privacy when designing and developing an app that displays data in ambient +mode. For example, while keeping a messaging app on the screen could be convenient for a user who is +in an ongoing conversation, displaying personal messages on the screen for an extended period of +time while the app is in ambient mode may bother some users. Consider removing potentially private +data after a short period of inactivity or refrain from showing sensitive data in ambient mode. +