Skip to content

Most visited

Recently visited


Building TV Playback Apps

Dependencies and Prerequisites

  • Android 5.0 (API level 21) or higher

You should also read


DevBytes: Android TV — Using the Leanback library

Browsing and playing media files is frequently part of the user experience provided by a TV app. Building such an experience from scratch, while making sure that it is fast, fluid, and attractive can be quite challenging. Whether your app provides access to a small or large media catalog, it is important to allow users to quickly browse options and get to the content they want.

The Android framework provides classes for building user interfaces for these types of apps with the v17 leanback support library. This library provides a framework of classes for creating an efficient and familiar interface for browsing and playing media files with minimal coding. The classes are designed to be extended and customized so you can create an experience that is unique to your app.

This class shows you how to build a TV app for browsing and playing media content using the Leanback support libraries for TV.


Creating a Catalog Browser
Learn how to use the Leanback support library to build a browsing interface for media catalogs.
Providing a Card View
Learn how to use the Leanback support library to build a card view for content items.
Building a Details View
Learn how to use the Leanback support library to build a details page for media items.
Use Leanback's Transport Controls
Learn how to use the Leanback support library to build transport controls for your video player.
Displaying a Now Playing Card
Learn how to use a MediaSession to display a Now Playing card on the home screen.
Render Video Directly on a Surface
Learn how your app can render a preview video directly on a surface of the home screen.
Adding a Guided Step
Learn how to use the Leanback support library to guide a user through a series of decisions.
Introducing First-time Users to Your App
Learn how to use the Leanback support library to show first-time users how to get the most out of your app.
Enabling Background Playback
Learn how to continue playback when the user clicks on Home.
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


Follow Google Developers on WeChat

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 short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)