Welcome to Knowledge Base!

Users have different expectations when watching TV, compared to using a phone or tablet.
A typical TV user sits about 10 feet away from the screen, so small details are less noticeable
and small text is hard to read. Since users sit away from a TV, they must use a remote
control device to navigate and make selections rather than touching elements on the screen. These
differences significantly affect the requirements for what makes a good TV user experience.

The first step toward creating a great experience for TV users is to review and follow the
Android TV design guidelines, which provides
instructions on how to build the best user experience for TV apps. You should also review the
Building TV Apps training, to understand the
fundamental implementation requirements for a TV app.

Important: To ensure a great user experience, apps for TV devices must meet
specific requirements for usability. Only apps that meet the following quality criteria will
qualify as an Android TV app on Google Play.

Note: For information about how to publish your TV apps in Google
Play, see
Distributing to Android TV.

These criteria ensure that your app follows critical design and interaction patterns
to ensure a consistent, intuitive, and enjoyable user experience on TV devices.

These criteria ensure that your app is configured correctly and provides the expected
functional behavior.

After I submit my app, how will find out if my app does not meet all the requirements for
TV devices?

If your app does not meet the usability requirements described on this page, the Play Store team
will contact you through the email address specified in the Google Play Console account associated with
the app.

Caution: Make sure your app includes the required manifest entries for TV devices,
otherwise your app will not be considered a TV app and will not be reviewed for TV usability
requirements.

My app targets more than just TV devices. If my app does not meet the TV device
requirements, will my new or updated app still appear on Google Play for other devices?

Yes. The requirements described above only excludes distribution to Google Play on TV
devices. Distribution to other device types, such as phones and tablets, is not affected.

If my app meets the publishing requirements, when will it be available in the Google
Play Store on TV devices?

Apps that meet the requirements for TV will appear on the Play Store on TV devices immediately.

Access to reliable power supplies varies, and outages can disrupt planned
charges. Defend your users' batteries against unnecessary drain by benchmarking
your battery use, avoiding wakelocks, scheduling tasks, and monitoring sensor
requests.

Reduce battery consumption

There are several steps you can take to help make sure that your app
is only consuming battery power when it needs to, and that it's not
consuming more power than necessary.

• Your app should minimize its activity when in the background and when the
  device is running on battery power.


• Sensors, such as GPS sensors, can drain battery significantly. Avoid issues by using the
  FusedLocationProvider API to manage the
  underlying location technology. It provides a simple API so that you can
  specify requirements—such as high accuracy or low power—at a high
  level. It also optimizes the device's use of battery power by caching
  locations and batching requests across apps. For more information about the
  ideal ways to request location, see the Getting the Last
  Known Location training guide.
  


• Wake
  locks are mechanisms to keep devices on so that they can perform
  background activities. Avoid using wake locks because they prevent the
  device from going into low-power states.


• To reduce the number of device wake-ups, batch network activity. For more
  information on batching, see the Android training on
  Optimizing Downloads for Efficient Network Access.


• WorkManager schedules
  tasks and lets the system batch operations. This greatly simplifies the
  implementation of common patterns, such as waiting for network connectivity,
  device charging state, retries, and backoff. Use WorkManager to perform
  non-essential background activity when the device is charging and is
  connected to an unmetered network.


• For more information on how network activity can drain the battery, and
  how to tackle this issue, see Reducing Network Battery Drain.
  

Benchmark battery use

Benchmarking your app’s battery use in a controlled environment helps you
understand the battery-heavy tasks in your app. It's a good practice to
benchmark your app’s battery use to gauge efficiency and track changes
over time.
Batterystats collects battery data about your apps, and
Battery Historian converts that data into an HTML visualization.

For
more information on reducing battery use, see the Android training on Optimizing
Battery Life.

Related

Over half of all users worldwide will experience your app over a 2G
connection. To improve their experience, optimize for low-speed
connections and offline working by storing data, queuing requests, and handling
images for optimal performance.

Here you can find some tips on how to accomplish these things.

Optimize images

There are a number of ways to make images easier to download. These include serving WebP images,
dynamically sizing images, and using image-loading libraries.

Serve WebP images

• Serve WebP files over the
  network to reduce image load times and save network bandwidth. A WebP file is often
  smaller in size than its PNG and JPG counterparts, with at
  least the same image quality. Even using lossy settings, WebP can produce a
  nearly identical image to the original. Android has included lossy WebP support since
  Android 4.0 (API level 14: Ice Cream Sandwich) and support for lossless,
  transparent WebP since Android 4.2 (API level 17: Jelly Bean).

Dynamically size images

• Have your apps request images at the target rendering size, based on the device specification,
  and your server provide appropriately sized images. Doing this minimizes the data sent over the
  network and reduces the amount of memory needed to hold each image,
  resulting in improved performance and user satisfaction.


• User experience degrades when users have to wait for images to
  download. Using appropriate image sizes helps to address these issues.
  Consider making image size requests based on network type or network
  quality; this size could be smaller than the target rendering size.


• Dynamic placeholders such as
  pre-computed palette values or low-resolution thumbnails can improve
  the user experience while the image is being fetched.

Use image loading libraries

• Your app should not fetch any image more than once. Image
  loading libraries such as Glide and Picasso
  fetch the image, cache it, and provide hooks into your Views to show
  placeholder images until the actual images are ready. Because images are
  cached, these libraries return the local copy the next time an image is
  requested.


• Image-loading libraries manage their cache, holding onto the most recent
  images so that your app storage doesn’t grow indefinitely.

Optimize networking

You can enhance the user experience by providing an optimal
network experience.

For example, you can make your app usable offline, use

WorkManager and Room,
and deduplicate network requests.

Make your app usable offline

• In rural location and less affluent areas, it’s
  common for devices to lose network connectivity. Creating a useful offline
  state means users can interact with your app at all times. Do this by storing data locally,
  caching data, and queuing outbound requests to action when connectivity is restored.


• Where possible, apps shouldn’t notify users that connectivity has
  been lost. It’s only when the user performs an operation where connectivity
  is essential that the user needs to be notified.


• When a device lacks connectivity, your app should batch up network
  requests—on behalf of the user—that can be executed when
  connectivity is restored. An example of this is an email client that allows
  users to compose, send, read, move, and delete existing mails even when the
  device is offline. These operations can be cached and executed when
  connectivity is restored. In doing so, the app is able to provide a similar
  user experience whether the device is online or offline.

Use Room to fetch and cache data

• Ensure that your app stores all data on disk using a database or similar
  structure so that it performs optimally regardless of network conditions.
  Use the Room persistence
  library to cache data in a local database, and use
  WorkManager to update
  that cache when the device has a network connection.


• Apps should cache content that is fetched from the network. Before making
  subsequent requests, apps should display locally cached data. This ensures
  that the app is functional regardless of whether the device is offline or
  on a slow or unreliable network.

Deduplicate network requests

• An offline-first architecture initially tries to fetch data from local
  storage and, failing that, requests the data from the network. After being
  retrieved from the network, the data is cached locally for future
  retrieval. This helps to ensure that network requests for the same piece of
  data only occur once—with subsequent requests satisfied locally. To
  achieve this, use a local database for long-lived data (usually
  android.database.sqlite or
  SharedPreferences).


• This architecture also simplifies an app’s flow between offline and
  online states as one side fetches from the network to the cache, while the
  other retrieves data from the cache to present to the user.


• For transitory data, use a bounded disk cache such as a DiskLruCache.
  Data that doesn’t typically change should only be requested once over
  the network and cached for future use. Examples of such data are images and
  non-temporal documents like news articles or social posts.

Fine-tune data transfer

There are several ways in which your app can adapt to network conditions to provide a
better user experience. For example, it can prioritize network requests to minimize
the user's waiting time for information. It can also detect and adapt to slower network
speeds and changes that may take place in the network connection.

Prioritize bandwidth

• You shouldn't assume that any network that the device is
  connected to is long-lasting or reliable. For this reason, apps should
  prioritize network requests to display the most useful information to the
  user as soon as possible.


• Presenting users with visible and relevant information immediately is a
  better user experience than making them wait for information that might not
  be necessary. This reduces the time that the user has to wait and
  increases the usefulness of the app on slow networks.


• To achieve this, sequence your network requests such that text is
  fetched before rich media. Text requests tend to be smaller, compress
  better, and hence transfer faster, meaning that your app can display useful
  content quickly. For more information on managing network requests, visit
  the Android training on Managing Network
  Usage.

Use less bandwidth on slower connections

• The ability for your app to transfer data in a timely fashion is
  dependent on the network connection. Detecting the quality of the network
  and adjusting the way your app uses it can help provide an excellent user
  experience.


• You can use the following methods to detect the underlying network
  quality. Using the data from these methods, your app should tailor its use
  of the network to continue to provide a timely response to user actions:
  
  
  
  • ConnectivityManager>
    isActiveNetworkMetered()
  
  
  • ConnectivityManager>
    getActiveNetworkInfo()
  
  
  • ConnectivityManager>
    getNetworkCapabilities(Network)
  
  
  • TelephonyManager>
    getNetworkType()
  
  
  
  


• On slower connections, consider downloading only lower-resolution media
  or perhaps none at all. This ensures that your users can use
  the app on slow connections. Where you don’t have an image or the image is
  still loading, you should always show a placeholder. You can create a
  dynamic placeholder by using the
  Palette library to generate placeholder colors that match the target
  image.


• On devices powered by Android 7.0 (API level 24) and higher,
  users can turn on the
  Data Saver setting, which helps minimize data use. Android 7.0
  extends ConnectivityManager to detect Data Saver
  settings. For more information about this feature, see
  Data Saver.
  

Detect network changes, then change app behavior

• Network quality is not static; it changes based on location, network
  traffic, and local population density. Apps should detect changes in
  network and adjust bandwidth accordingly. By doing so, your app can tailor
  the user experience to the network quality. Detect network state using
  these methods:
  
  
  
  • ConnectivityManager>
    getActiveNetworkInfo()
  
  
  • ConnectivityManager>
    getNetworkCapabilities(Network)
  
  
  • TelephonyManager>
    getDataState()
  
  
  
  


• As the network quality degrades, scale down the number and size of
  requests. As the connection quality improves, you can scale up your
  requests to optimal levels.


• On higher quality, unmetered networks, consider
  prefetching data to make it available ahead of time. From a user
  experience standpoint, this might mean that news reader apps fetch
  three articles at a time on 2G but fetch twenty articles at a time on
  Wi-Fi. For more information on adjusting app behavior based on network changes,
  visit the Android training on
  Monitoring the Connectivity Status.


• The broadcast
  CONNECTIVITY_CHANGE is sent when a change in network
  connectivity occurs. When your app is in the foreground, you can call
  registerReceiver to receive this broadcast. After receiving
  the broadcast, you should reevaluate the current network state and adjust
  your UI and network use appropriately. You shouldn't declare this receiver
  in your manifest, as it's unavailable in Android 7.0 (API level 24)
  and higher.
  For more information about this and other changes in Android 7.0,
  see
  Android 7.0 Changes.

Related

Additional resources

To learn more about supporting a variety of connection speeds, view the following
resource:

Blog post

• Connect,
  No Matter the Speed