Explore common use cases
Stay organized with collections
Save and categorize content based on your preferences.
When designing media apps, prioritize the following use cases. Allow users to do
the following:
- Listen to downloaded media
- Stream media from the watch
Listen to downloaded media
The following examples show how to help users listen to downloaded media.
Users can manually download media items from an entity page. Show the user the
download location, progress, and size.
Entity page
Size of download (Dialog)
Download progress
Browse downloaded media
When the user browses media, display recently downloaded media.
Downloads
Browse
Entity page
Remove downloaded media
If content is already downloaded, show an action to remove the downloaded media
from the device.
Downloaded
Remove download (Dialog)
Entity page
Select output device
If the source device is the watch, prompt users to select audio output
before they start listening to music. After the user selects an output device,
play the media and display the output device icon—such as a headset or buds—on
the media controls.
Media Player without output
System output switcher (Dialog)
Media Player with output
Stream media
Streaming from the watch drains the battery. Prioritize downloaded content
when users choose to listen on the watch by displaying recently used downloads
on the browse list. Add a button that takes users to a full list of downloads,
as shown in the following images.
Prioritize downloaded content
Downloads button
Downloads list
For more information, see the Media Toolkit on GitHub.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-07-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-02 UTC."],[],[],null,["# Explore common use cases\n\nWhen designing media apps, prioritize the following use cases. Allow users to do\nthe following:\n\n- Listen to downloaded media\n- Stream media from the watch\n\nListen to downloaded media\n--------------------------\n\nThe following examples show how to help users listen to downloaded media.\n\n### Download media\n\nUsers can manually download media items from an entity page. Show the user the\ndownload location, progress, and size. \n\n\u003cbr /\u003e\n\nEntity page\n\n\u003cbr /\u003e\n\nSize of download (Dialog)\n\n\u003cbr /\u003e\n\nDownload progress\n\n\u003cbr /\u003e\n\n### Browse downloaded media\n\nWhen the user browses media, display recently downloaded media. \n\n\u003cbr /\u003e\n\nDownloads\n\n\u003cbr /\u003e\n\nBrowse\n\n\u003cbr /\u003e\n\nEntity page\n\n\u003cbr /\u003e\n\n### Remove downloaded media\n\nIf content is already downloaded, show an action to remove the downloaded media\nfrom the device. \n\n\u003cbr /\u003e\n\nDownloaded\n\n\u003cbr /\u003e\n\nRemove download (Dialog)\n\n\u003cbr /\u003e\n\nEntity page\n\n\u003cbr /\u003e\n\n### Select output device\n\nIf the source device is the watch, prompt users to [select audio output](/training/wearables/apps/audio#prompt-the-user-to-connect-a-headset)\nbefore they start listening to music. After the user selects an output device,\nplay the media and display the output device icon---such as a headset or buds---on\nthe media controls. \n\n\u003cbr /\u003e\n\nMedia Player **without** output\n\n\u003cbr /\u003e\n\nSystem output switcher (Dialog)\n\n\u003cbr /\u003e\n\nMedia Player **with** output\n\n\u003cbr /\u003e\n\nStream media\n------------\n\nStreaming from the watch drains the battery. Prioritize downloaded content\nwhen users choose to listen on the watch by displaying recently used downloads\non the browse list. Add a button that takes users to a full list of downloads,\nas shown in the following images. \n\n\u003cbr /\u003e\n\nPrioritize downloaded content\n\n\u003cbr /\u003e\n\nDownloads button\n\n\u003cbr /\u003e\n\nDownloads list\n\n\u003cbr /\u003e\n\nFor more information, see the [Media Toolkit](https://github.com/google/horologist/tree/main/media) on GitHub."]]
