Skip to content

Most visited

Recently visited

navigation

Optimizing Watch Faces

A watch face runs continuously, so it must use power efficiently.

Additionally, the performance of the watch face should be optimized. Services must not perform unnecessary computations. Watch faces with animations must run smoothly while accommodating notifications and system indicators.

Basic optimization

This section contains best practices for improving efficiency during periods when a watch face is inactive.

Use callbacks in WatchFaceService.Engine

Ensure that your watch face performs computations only when active; use callbacks in WatchFaceService.Engine. Preferably, use the following methods of that class to determine if the watch face is visible:

Alternatively, use the following methods of the same class (WatchFaceService.Engine):

Use listeners registered with the DataApi interface

To listen for events, use live listeners that are registered with DataApi.addListener. For an example, see Syncing Data Items.

Do not use WearableListenerService to listen for events, because it is called whether or not a watch face is active. For more information, see Deprecation of BIND_LISTENER with Android Wear APIs.

Do not register a broadcast receiver in the Android manifest file to get system events such as time zone changes, battery events, etc., because the BroadcastReceiver is called whether or not a watch face is active. However, you can use the registerReceiver method of the Context class to register a receiver.

Monitor power consumption

The Android Wear companion app enables developers and users to see how much battery is consumed by different processes on the wearable device (under Settings > Watch battery).

For information about features introduced in Android 5.0 that help you improve battery life, see Project Volta.

Register encryption-aware watch faces

Android 7.0 and higher include support for file-based encryption and allows encryption-aware applications to run before the user has provided the decryption passcode at bootup. This can reduce the duration of transitioning from boot animation to the watch face by up to 30 seconds.

To enable faster bootup, add android:directBootAware="true" to the watch face manifest.

Note: Use this feature with watch faces that do not use credential encrypted storage.

Best practices for animations

The best practices in this section help to reduce the power consumption of animations.

Reduce the frame rate of animations

Animations are often computationally expensive and consume a significant amount of power. Most animations look fluid at 30 frames per second, so you should avoid running your animations at a higher frame rate.

Let the CPU sleep between animations

Animations and small changes to the contents of the watch face wake up the CPU. Your watch face should let the CPU sleep in between animations. For example, you can use short bursts of animation every second in interactive mode and then let the CPU sleep until the next second. Letting the CPU sleep often, even briefly, can significantly reduce power consumption.

To maximize battery life, use animations sparingly. Even a blinking colon wakes up the CPU with every blink and hurts battery life.

Reduce the size of your bitmap assets

Many watch faces consist of a background image and other graphic assets that are transformed and overlapped on top of the background image, such as clock hands and other elements of the design that move over time. Typically these graphic elements are rotated (and sometimes scaled) inside the Engine.onDraw() method every time the system redraws the watch face, as described in Draw Your Watch Face.

The larger these graphic assets are, the more computationally expensive it is to transform them. Transforming large graphic assets in the Engine.onDraw() method drastically reduces the frame rate at which the system can run your animations.

Figure 1. Clock hands can be cropped to remove extra pixels.

To improve the performance of your watch face:

The example clock hand on the left side of Figure 1 can be reduced in size by 97%.

Reducing the size of your bitmap assets as described in this section not only improves the performance of your animations, but it also saves power.

Combine bitmap assets

If you have bitmaps that are often drawn together, consider combining them into the same graphic asset. You can often combine the background image in interactive mode with the tick marks to avoid drawing two full-screen bitmaps every time the system redraws the watch face.

Disable anti-aliasing when drawing scaled bitmaps

When you draw a scaled bitmap on the Canvas object using the Canvas.drawBitmap() method, you can provide a Paint instance to configure several options. To improve performance, disable anti-aliasing using the setAntiAlias() method, since this option does not have any effect on bitmaps.

Figure 2. Example of bitmap filtering disabled (left) and enabled (right).

Use bitmap filtering

For bitmap assets that you draw on top of other elements, enable bitmap filtering on the same Paint instance using the setFilterBitmap() method. Figure 2 shows a magnified view of a clock hand with and without bitmap filtering.

Note: In low-bit ambient mode, the system does not reliably render the colors in the image for bitmap filtering to process successfully. When ambient mode is active, disable bitmap filtering.

Move expensive operations outside the drawing method

The system calls the Engine.onDraw() method every time it redraws your watch face, so you should only include operations that are strictly required to update the watch face inside this method to improve performance.

When possible, avoid performing these operations inside the Engine.onDraw() method:

You can usually perform these operations in the Engine.onCreate() method instead. You can resize images ahead of time in the Engine.onSurfaceChanged() method, which provides you with the size of the canvas.

To analyze the performance of your watch face, use the Android Device Monitor. In particular, ensure that the execution time for your Engine.onDraw() implementation is short and consistent across invocations. For more information, see Using DDMS.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.