diff --git a/docs/html/design/tv/patterns.jd b/docs/html/design/tv/patterns.jd index 51bb699eec345..768dcfcab703c 100644 --- a/docs/html/design/tv/patterns.jd +++ b/docs/html/design/tv/patterns.jd @@ -29,7 +29,7 @@ page.title=UI Patterns for TV The visual specifications for these icons are shown below.

-

Banners

+

App Banners represent your app on the home screen of TV devices and serve and as a way for users to launch your app. Here are specific requirements for a banner image: diff --git a/docs/html/design/tv/style.jd b/docs/html/design/tv/style.jd index 6e2704b29f6fc..dd10a8a606b01 100644 --- a/docs/html/design/tv/style.jd +++ b/docs/html/design/tv/style.jd @@ -70,7 +70,7 @@ page.title=Style for TV exaggerated contrast, causing them to be indistinguishable.

-

Typography

+

Typography

The text and controls in a TV application's UI should be easily visible and navigable from a distance. The minimum recommended font size for TV is 12sp. The default text size setting should diff --git a/docs/html/distribute/essentials/essentials_toc.cs b/docs/html/distribute/essentials/essentials_toc.cs index d0a11141dbde7..4e53468b51944 100644 --- a/docs/html/distribute/essentials/essentials_toc.cs +++ b/docs/html/distribute/essentials/essentials_toc.cs @@ -10,6 +10,12 @@ +

  • +
    + TV App Quality + +
    +
  • Optimize Your App diff --git a/docs/html/distribute/essentials/quality/tv.jd b/docs/html/distribute/essentials/quality/tv.jd new file mode 100644 index 0000000000000..8e1715763b180 --- /dev/null +++ b/docs/html/distribute/essentials/quality/tv.jd @@ -0,0 +1,513 @@ +page.title=TV App Quality +page.metaDescription=TV is a growing segment of Android devices that requires specific attention to app design and functionality in order to create a great experience. +page.image=/distribute/images/gp-tv-quality.png +@jd:body + + + +
    + +
    + +

    + Users have a different set of 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 screen. These + differences significantly change 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 + basic implementation requirements for a TV app. +

    + +

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

    + +

    + Note: You will be able to submit TV apps to Google Play with the public release + of Android 5.0 on November 3. Stay tuned for more information about how to submit your TV apps + through the Google Play Developer Console. +

    + + +
    +

    + Visual Design and User Interaction +

    + + +
    + +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + Type + + Test + + Description +
    + Launcher + + TV-LM + +

    + App displays a launcher icon in the Android TV Launcher after installation. + (Learn how) +

    +
    + TV-LB + +

    + App displays a 320px x 180px full-size banner as its launcher icon in the Android TV Launcher. + (Learn how) +

    +
    + TV-BN + +

    + App launch banner contains the name of the app. + (Learn how) +

    +
    + TV-LG + +

    + If the app is a game, it appears in the Games row in the Android TV Launcher.
    + (Learn how) +

    +
    + Layout + + TV-LO + +

    + All app interfaces are presented in landscape orientation. + (Learn how) +

    +
    + TV-TC + +

    + App displays core text at 16sp or higher in size. + (Learn how) +

    +
    + TV-TA + +

    + App displays all text at 12sp or higher in size. + (Learn how) +

    +
    + TV-OV + +

    + App does not display any text or functionality that is partially cut off by the + edges of the screen. + (Learn how) +

    +
    + TV-TR + +

    + App does not partially obscure other apps. App fills the entire screen and has a + non-transparent background. +

    +
    + TV-DP + +

    + App functionality is navigable using 5-way D-pad controls, unless the app + requires a gamepad controller as specified in TV-GP. + (Learn how) +

    +
    + TV-DK + +

    + If the app requires a game controller, as specified in TV-GP, all + functionality is navigable using standard Android game controller keys. + (Learn how) +

    +
    + TV-DM + +

    + App does not depend on a remote controller having a menu button to access user interface + controls. + (Learn how) +

    +
    + + +

    Related resources

    + +
    +
    + + + +
    +

    + Functionality +

    + + +
    + +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + Type + + Test + + Description +
    + Manifest + + TV-ML + +

    + App manifest sets an intent type of {@code ACTION_MAIN} with category + {@code CATEGORY_LEANBACK_LAUNCHER}. + (Learn how) +

    +
    + TV-MT + +

    + App manifest sets the hardware feature {@code android.hardware.touchscreen} to not required. + (Learn + how) +

    +
    + Game Controllers + + TV-GP + +

    + If the app requires a game controller, the app manifest sets the {@code uses-feature} setting + {@code android.hardware.gamepad} to {@code required="true"}. + (Learn how) +

    +
    + TV-GC + +

    + If the app provides user instructions for use of game controllers, the instructions + do not include a controller with any branding. + (Learn how) +

    +
    + Advertising + + TV-AP + +

    + App enables interaction with any advertising using D-pad controls. + (Learn how) +

    +
    + TV-AD + +

    + For advertising that uses full-screen, non-video ads, the app allows the user to + immediately dismiss the ad with D-pad controls. +

    +
    + TV-AU + +

    + For advertising that uses clickable, non-full screen, non-video ads, the app does not allow + ads to link to a web URL. +

    +
    + TV-AA + +

    + For advertising that uses clickable, non-full screen, non-video ads, the app does not allow + ads to link to another app that is not available on TV devices. +

    +
    + Web Content + + TV-WB + +

    + For web content, the app uses {@link android.webkit.WebView} components and does not attempt + to launch a web browser app. +

    +
    + Media Playback + + TV-NP + +

    + If the app continues to play sound after the user has left, the app provides a Now + Playing card on the home screen recommendation row so users can return to the app to + control playback. + (Learn how) +

    +
    + TV-PA + +

    + If the app provides a Now Playing card, selecting this card takes the user to + a screen that allows playback to be paused. + (Learn how) +

    +
    + TV-PP + +

    + If the app plays video or music content, the app toggles between play and pause of media + playback when a play or pause key event is sent during playback.
    + (Learn + how) +

    +
    + + +

    Related resources

    + +
    +
    + + +
    +

    + Frequently Asked Questions +

    +
    + +

    + 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 main Google Play Developer 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 phones and + tablets? +

    +

    + Yes. The requirements described above only restrict distribution to the Google Play Store on TV + devices. Distribution to other device types, such as phones, tablets and other devices, 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 in the Google Play Store on TV devices + after the official release of Android 5.0. +

    \ No newline at end of file diff --git a/docs/html/distribute/images/gp-tv-quality.png b/docs/html/distribute/images/gp-tv-quality.png new file mode 100644 index 0000000000000..44da11b536310 Binary files /dev/null and b/docs/html/distribute/images/gp-tv-quality.png differ diff --git a/docs/html/jd_collections.js b/docs/html/jd_collections.js index e2a7f1c1e8aea..c49f8cc931234 100644 --- a/docs/html/jd_collections.js +++ b/docs/html/jd_collections.js @@ -4,7 +4,7 @@ var RESOURCE_COLLECTIONS = { "resources": [ "training/building-wearables.html", "training/material/index.html", - "sdk/installing/studio.html" + "sdk/installing/studio.html" ] }, "distribute/edu/videos/stories": { @@ -66,9 +66,9 @@ var RESOURCE_COLLECTIONS = { "resources": [ "distribute/essentials/quality/core.html", "distribute/essentials/quality/tablets.html", + "distribute/essentials/quality/tv.html", "https://developers.google.com/edu/guidelines", "distribute/essentials/optimizing-your-app.html", - "distribute/essentials/best-practices/apps.html", "distribute/essentials/best-practices/games.html" ] }, @@ -318,6 +318,20 @@ var RESOURCE_COLLECTIONS = { "training/basics/activity-lifecycle/recreating.html" ] }, + "distribute/essentials/tvqualityguidelines/visualdesign": { + "title": "", + "resources": [ + "design/tv/index.html", + "training/tv/start/index.html" + ] + }, + "distribute/essentials/tvqualityguidelines/functionality": { + "title": "", + "resources": [ + "training/tv/start/hardware.html", + "training/tv/games/index.html" + ] + }, "distribute/essentials/core/performance": { "title": "", "resources": [ @@ -705,7 +719,7 @@ var RESOURCE_COLLECTIONS = { "google/play/billing/index.html", "https://support.google.com/googleplay/android-developer/answer/4407611" ] - }, + }, "distribute/monetize/freemium": { "title": "", "resources": [ diff --git a/docs/html/preview/tv/publish/index.jd b/docs/html/preview/tv/publish/index.jd deleted file mode 100644 index f834493f0725a..0000000000000 --- a/docs/html/preview/tv/publish/index.jd +++ /dev/null @@ -1,205 +0,0 @@ -page.title=Publishing TV Apps -page.tags="requirements","usability" - -@jd:body - - - -

    - Apps for TV devices can be published like other Android apps. You must prepare your app for - release and then you can publish it through Google Play. In order for your app to be - accepted as a TV app in Google Play, it must meet some additional requirements, which are covered - in this document. -

    - -

    - Note: You will not be able to publish apps to TV devices through Google Play until Android L SDK is released. -

    - - -

    Publishing Requirements for TV Apps

    - -

    - Your app must provide specific manifest declarations and meet some minimum usability requirements - before it can qualify as TV app on Google Play. Make sure your app meets these requirements to - get your app ready for TV devices. -

    - -

    - Caution: Your app must meet all of the requirements described in this section in - order to qualify as a TV app on Google Play. If your app does not meet the usability requirements - described below, the Google Play team will contact you through the email address specified in main - Google Play Developer Console account - associated with the app. -

    - -

    Manifest Requirements

    - -

    - Developers who want their apps to be considered for publishing on TV devices must - include a manifest entry that declares an activity which handles the {@code - android.intent.category.LEANBACK_LAUNCHER} intent filter. For more information about including - the required manifest entries, see Get Started with TV Apps. -

    - -

    - Caution: If you do not include the required manifest entries for TV devices, - your app is not considered as a TV app. The app will not be reviewed for the TV app usability - requirements and will not be able to qualify as a TV app on Google Play. -

    - - -

    Usability Requirements

    - -

    - Users bring a different set of expectations when watching TV. Apps for Android TV devices have a - different interaction, look and feel from Android apps on the phone or tablet. How users interact - with TVs (with a remote control device) and how they view them (sitting about 10 feet away), - significantly changes the requirements for what makes a good user experience in an app. -

    - -

    - The first step toward creating a great experience for users on TV is to review and follow the - Design for TV guidelines. These guidelines - provide general directions for designing a TV app as well as some specific implementation - instructions. -

    - -

    - Apps for TV devices must meet some specific requirements for usability. Only apps that meet the - following usability criteria will qualify as an TV app on Google Play: -

    - - - - -

    Frequently Asked Questions

    - -

    - 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 main Google Play Developer 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 phones and - tablets? -

    -

    - Yes. The requirements described above only restrict distribution to the Google Play Store on TV - devices. Distribution to other device types, such as phones, tablets and other devices, 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 in the Google Play Store on TV devices - after the official release of Android L. -

    \ No newline at end of file