Android users engage with different media types, including audiobooks, music, podcasts, and radio. It's important to design apps that allow users to conveniently access media content on their watch. The watch is a unique surface on which ease and speed of interactions is a high priority, as users spend much less time interacting with their watch than their phone or tablet.
For more information, see the Media Toolkit on GitHub.
Media app architecture
Create media apps that satisfy Wear OS's design requirements. Media apps often include Browse and Entity pages.
![](https://developer.android.com/static/wear/images/media-apps/MP_2_Browse.png?authuser=8)
Browse
Lets users find media to play. Prioritize downloaded items to help users quickly start or resume playback.
![](https://developer.android.com/static/wear/images/media-apps/MP_3_Entity.png?authuser=8)
Entity
Gives users more information about a specific media item. Important context and key actions should be readily available, such as download, play, or shuffle.
Reduce your app hierarchy and expose media for the user. Design with a flat information architecture that allows users to quickly access lists and showcase thumbnails for users. Consider using custom design components for Wear OS. For more information, check out design recommendations for Chips and Cards.
Media control screens
Media apps should also include media control screens. Create media controls using a 5-button layout. This is to ensure that minimum tap targets are met. The following are examples of media controls for a music app and a podcast app:
Adapt the media controls that you display, depending on the type of content. Use a three-dot overflow icon to take users to an additional page if you want to include more than 5 actions. You can use custom icons and fonts for your app.
![](https://developer.android.com/static/wear/images/media-apps/Image-MediaVolume.png?authuser=8)
Control the volume
Volume controls are one of the most important media controls for users on the watch. Media controls should include a volume button to enter the volume controls screen.
Most Wear OS devices have a rotating side button (RSB) or a bezel. Some Wear OS devices also have additional hardware buttons to control volume. Use the RSB, bezel, or the additional button to control the volume. Show the indicator only when the RSB or bezel is rotated, as shown in the example.
Common use cases
When designing media apps, be sure that you prioritize the following important use cases:
- Listen to downloaded media
- Stream music from the watch
Listen to downloaded media
Users should be able to manually download media items from an entity page.
Communicate to the user where they are downloading content, the progress of the download, the time it takes, and the size of the download, as shown in the following example:
When the user browses media, display the most recently downloaded media:
If content is already downloaded, make this clear by showing an action to remove the download from the watch. In this case, you must also show how much space the download is taking up on the watch, as shown in the following image:
If the source device is the watch, prompt users to connect a headset before they begin listening to music. Once a headset is connected, play the media and open media controls.
Stream music from the watch
Streaming media from the watch has a significant effect on a Wear OS device's battery. Prioritize downloaded content when users choose to listen on their Wear OS device by exposing recently used downloads on the browse list. Consider adding a button that takes them to a full list of downloads, as shown in the following images:
For more information, see the Media Toolkit on GitHub.
Adaptive layouts
The larger screen adaptations for media apps are solely focused on the media player experience. All other elements are captured in Chips, Buttons, Dialogs, and Lists pages that describe proper app behavior to accommodate larger screens.
Button configuration
To follow touch target sizing principles, show a 2-button layout on Wear OS devices that are smaller than 225 dp, and a 3-button layout on devices with larger screens. The following images outline additional examples, such as a 1-button layout, and a 2-button layout with a logo:
![](https://developer.android.com/static/wear/images/media-apps/MP_11_BC1.png?authuser=8)
![](https://developer.android.com/static/wear/images/media-apps/MP_11_BC2.png?authuser=8)
![](https://developer.android.com/static/wear/images/media-apps/MP_11_BC3.png?authuser=8)
![](https://developer.android.com/static/wear/images/media-apps/MP_11_BC4.png?authuser=8)
![](https://developer.android.com/static/wear/images/media-apps/MP_11_BC5.png?authuser=8)
![](https://developer.android.com/static/wear/images/media-apps/MP_11_BC6.png?authuser=8)
Responsive control button
Main control (Play/Pause) scales from 60 dp to 80 dp on Wear OS devices larger than 225 dp, making the middle section 80 dp high, and therefore increasing tap targets for all controls within it. This is built in responsive behavior which you will inherit from the Media Player template.
![](https://developer.android.com/static/wear/images/media-apps/MP_12_Atom.png?authuser=8)
Scaling on different screen sizes:
< 225 dp: 60 dp x 60 dp
> 225 dp: 80 dp x 80 dp
Marquee behavior
Within the header, use a universal margin of 9.38%, with an additional Song title margin of 4.16%. Use 8 dp gradient for scrolling titles, and an additional 8 dp gap when an icon is present. Include any marquee scrolling transitions underneath the icon, whose position remains fixed.
![](https://developer.android.com/static/wear/images/media-apps/MP_13_MB1.png?authuser=8)
Header atom margins
9.38%
Song title internal margin
4.16%
Gradients
8 dp bleed
Icon gap
8 dp
![](https://developer.android.com/static/wear/images/media-apps/MP_13_MB2.png?authuser=8)
![](https://developer.android.com/static/wear/images/media-apps/MP_13_MB3.png?authuser=8)
![](https://developer.android.com/static/wear/images/media-apps/MP_13_MB4.png?authuser=8)
![](https://developer.android.com/static/wear/images/media-apps/MP_13_MB5.png?authuser=8)
Tap targets
On Wear OS devices with larger screens, the icons in the middle and footer sections take advantage of the extra space to increase tap target sizes. This means that, aside from a fixed control atom, the "fill available space" properties are applied to icon containers:
![](https://developer.android.com/static/wear/images/media-apps/Content Shot.png?authuser=8)
Small Wear OS screens
< 225 dp
![](https://developer.android.com/static/wear/images/media-apps/media-tap-target-3.png?authuser=8)
Larger Wear OS screens
> 225 dp