diff options
Diffstat (limited to 'docs/html')
| -rw-r--r-- | docs/html/google/play-services/ads.jd | 6 | ||||
| -rw-r--r-- | docs/html/images/tv/app-browse.png | bin | 0 -> 226591 bytes | |||
| -rw-r--r-- | docs/html/images/tv/card-view.png | bin | 0 -> 307220 bytes | |||
| -rw-r--r-- | docs/html/sdk/index.jd | 4 | ||||
| -rw-r--r-- | docs/html/tools/devices/emulator.jd | 2 | ||||
| -rw-r--r-- | docs/html/training/training_toc.cs | 6 | ||||
| -rw-r--r-- | docs/html/training/tv/playback/card.jd | 156 | ||||
| -rw-r--r-- | docs/html/training/tv/playback/index.jd | 3 | ||||
| -rw-r--r-- | docs/html/training/tv/start/layouts.jd | 4 |
9 files changed, 171 insertions, 10 deletions
diff --git a/docs/html/google/play-services/ads.jd b/docs/html/google/play-services/ads.jd index e4f0b2c..2f915f3 100644 --- a/docs/html/google/play-services/ads.jd +++ b/docs/html/google/play-services/ads.jd @@ -98,10 +98,8 @@ header.hide=1 serve banner and interstitial ads using the Google Mobile Ads APIs.</p> <h4>3. Read the documentation</h4> - <p>Read the <a class="external-link" href="https://www.google.com/adsense/localized-terms">AdSense - Terms of Service</a> and the <a class="external-link" - href="https://support.google.com/admob/topic/1307235?hl=en&ref_topic=1307209">AdMob - publisher guidelines and policies</a>.</p> + <p>Your use of the Google Mobile Ads SDK is governed by the terms between you and Google that + govern your use of the Google product (AdSense/AdMob, AdX or DFP) with which you use the SDK.</p> <p>For quick access while developing your Android apps, the <a href="{@docRoot}reference/gms-packages.html">Google Mobile Ads API reference</a> is available here on developer.android.com.</p> diff --git a/docs/html/images/tv/app-browse.png b/docs/html/images/tv/app-browse.png Binary files differnew file mode 100644 index 0000000..7670713 --- /dev/null +++ b/docs/html/images/tv/app-browse.png diff --git a/docs/html/images/tv/card-view.png b/docs/html/images/tv/card-view.png Binary files differnew file mode 100644 index 0000000..5e907de --- /dev/null +++ b/docs/html/images/tv/card-view.png diff --git a/docs/html/sdk/index.jd b/docs/html/sdk/index.jd index d712196..1100964 100644 --- a/docs/html/sdk/index.jd +++ b/docs/html/sdk/index.jd @@ -482,14 +482,14 @@ rendering. You can then configure your project to use Java Development Kit (JDK) <ul> <li>GNOME or KDE desktop</li> -<li>GNU C Library (glibc) 2.11 or later</li> +<li>GNU C Library (glibc) 2.15 or later</li> <li>2 GB RAM minimum, 4 GB RAM recommended</li> <li>400 MB hard disk space</li> <li>At least 1 GB for Android SDK, emulator system images, and caches</li> <li>1280 x 800 minimum screen resolution</li> <li>Oracle® Java Development Kit (JDK) 7 </li> </ul> -<p>Tested on Ubuntu® 12.04, Precise Pangolin (64-bit distribution capable of running +<p>Tested on Ubuntu® 14.04, Trusty Tahr (64-bit distribution capable of running 32-bit applications).</p> diff --git a/docs/html/tools/devices/emulator.jd b/docs/html/tools/devices/emulator.jd index 42240b9..5bdd4e2 100644 --- a/docs/html/tools/devices/emulator.jd +++ b/docs/html/tools/devices/emulator.jd @@ -122,7 +122,7 @@ machine.</p> mobile devices, including: </p> <ul> - <li>An ARMv5 CPU and the corresponding memory-management unit (MMU)</li> + <li>An ARMv5, ARMv7, or x86 CPU</li> <li>A 16-bit LCD display</li> <li>One or more keyboards (a Qwerty-based keyboard and associated Dpad/Phone buttons)</li> diff --git a/docs/html/training/training_toc.cs b/docs/html/training/training_toc.cs index f5999a5..c59d8ff 100644 --- a/docs/html/training/training_toc.cs +++ b/docs/html/training/training_toc.cs @@ -951,6 +951,10 @@ include the action bar on devices running Android 2.1 or higher." Creating a Catalog Browser</a> </li> <li> + <a href="<?cs var:toroot ?>training/tv/playback/card.html"> + Providing a Card View</a> + </li> + <li> <a href="<?cs var:toroot ?>training/tv/playback/details.html" ja-lang="詳細ビューをビルドする"> Building a Details View</a> @@ -1883,4 +1887,4 @@ results." buildToggleLists(); changeNavLang(getLangPref()); //--> -</script> +</script>
\ No newline at end of file diff --git a/docs/html/training/tv/playback/card.jd b/docs/html/training/tv/playback/card.jd new file mode 100644 index 0000000..8ac75fd --- /dev/null +++ b/docs/html/training/tv/playback/card.jd @@ -0,0 +1,156 @@ +page.title=Providing a Card View +page.tags="card" + +trainingnavtop=true + +@jd:body + +<div id="tb-wrapper"> +<div id="tb"> + <h2>This lesson teaches you to</h2> + <ol> + <li><a href="#presenter">Create a Card Presenter</a></li> + <li><a href="#card-view">Create a Card View</a></li> + </ol> + <h2>Try it out</h2> + <ul> + <li><a class="external-link" href="https://github.com/googlesamples/androidtv-Leanback">Android + Leanback sample app</a></li> + </ul> +</div> +</div> + +<p>In the previous lesson, you created a catalog browser, implemented in a browse fragment, that +displays a list of media items. In this lesson, you create the card views for your media items and +present them in the browse fragment.</p> + +<p>The {@link android.support.v17.leanback.widget.BaseCardView} class and subclasses display the meta +data associated with a media item. The {@link android.support.v17.leanback.widget.ImageCardView} +class used in this lesson displays an image for the content along with the media item's title.</p> + +<p>This lesson describes code from the <a href="https://github.com/googlesamples/androidtv-Leanback"> +Android Leanback sample app</a>, available on GitHub. Use this sample code to start your own +app.</p> + +<img itemprop="image" src="{@docRoot}images/tv/app-browse.png" alt="App main screen"/> +<p class="img-caption"><b>Figure 1.</b> The <a href="https://github.com/googlesamples/androidtv-Leanback"> +Leanback sample app</a> browse fragment with a card presenter displaying card view objects.</p> + +<h2 id="presenter">Create a Card Presenter</h2> + +<p>A {@link android.support.v17.leanback.widget.Presenter} generates views and binds objects to them +on demand. In the browse fragment where your app presents its content to the user, you create a +{@link android.support.v17.leanback.widget.Presenter} for the content cards and pass it to the adapter +that adds the content to the screen. In the following code, the <code>CardPresenter</code> is created +in the {@link android.support.v4.app.LoaderManager.LoaderCallbacks#onLoadFinished(android.support.v4.content.Loader, java.lang.Object) onLoadFinished()} +callback of the {@link android.support.v4.app.LoaderManager}.</p> + +<pre> +@Override +public void onLoadFinished(Loader<HashMap<String, List<Movie>>> arg0, + HashMap<String, List<Movie>> data) { + + mRowsAdapter = new ArrayObjectAdapter(new ListRowPresenter()); + CardPresenter cardPresenter = new CardPresenter(); + + int i = 0; + + for (Map.Entry<String, List<Movie>> entry : data.entrySet()) { + ArrayObjectAdapter listRowAdapter = new ArrayObjectAdapter(cardPresenter); + List<Movie> list = entry.getValue(); + + for (int j = 0; j < list.size(); j++) { + listRowAdapter.add(list.get(j)); + } + HeaderItem header = new HeaderItem(i, entry.getKey(), null); + i++; + mRowsAdapter.add(new ListRow(header, listRowAdapter)); + } + + HeaderItem gridHeader = new HeaderItem(i, getString(R.string.more_samples), + null); + + GridItemPresenter gridPresenter = new GridItemPresenter(); + ArrayObjectAdapter gridRowAdapter = new ArrayObjectAdapter(gridPresenter); + gridRowAdapter.add(getString(R.string.grid_view)); + gridRowAdapter.add(getString(R.string.error_fragment)); + gridRowAdapter.add(getString(R.string.personal_settings)); + mRowsAdapter.add(new ListRow(gridHeader, gridRowAdapter)); + + setAdapter(mRowsAdapter); + + updateRecommendations(); +} +</pre> + +<h2 id="card-view">Create a Card View</h2> + +<p>In this step, you build the card presenter with a view holder for the card view that describes +your media content items. Note that each presenter must only create one view type. If you have two +different card view types then you need two different card presenters.</p> + +<p>In the {@link android.support.v17.leanback.widget.Presenter}, implement an +{@link android.support.v17.leanback.widget.Presenter#onCreateViewHolder(android.view.ViewGroup) onCreateViewHolder()} +callback that creates a view holder that can be used to display a content item.</p> + +<pre> +@Override +public class CardPresenter extends Presenter { + + private Context mContext; + private static int CARD_WIDTH = 313; + private static int CARD_HEIGHT = 176; + private Drawable mDefaultCardImage; + + @Override + public ViewHolder onCreateViewHolder(ViewGroup parent) { + mContext = parent.getContext(); + mDefaultCardImage = mContext.getResources().getDrawable(R.drawable.movie); +... +</pre> + +<p>In the {@link android.support.v17.leanback.widget.Presenter#onCreateViewHolder(android.view.ViewGroup) +onCreateViewHolder()} method, create a card view for content items. The sample below uses an +{@link android.support.v17.leanback.widget.ImageCardView}.</p> + +<p>When a card is selected, the default behavior expands it to a larger size. If you want to designate +a different color for the selected card, call {@link android.support.v17.leanback.widget.BaseCardView#setSelected(boolean) +setSelected()} +as shown here.</p> + +<pre> +... + ImageCardView cardView = new ImageCardView(mContext) { + @Override + public void setSelected(boolean selected) { + int selected_background = mContext.getResources().getColor(R.color.detail_background); + int default_background = mContext.getResources().getColor(R.color.default_background); + int color = selected ? selected_background : default_background; + findViewById(R.id.info_field).setBackgroundColor(color); + super.setSelected(selected); + } + }; +... +</pre> + +<p>When the user opens your app, the {@link android.support.v17.leanback.widget.Presenter.ViewHolder} +displays the <code>CardView</code> objects for your content items. You need to set these to receive +focus from the D-pad controller by calling {@link android.view.View#setFocusable(boolean) setFocusable(true)} +and {@link android.view.View#setFocusableInTouchMode(boolean) setFocusableInTouchMode(true)}.</p> + +<pre> +... + cardView.setFocusable(true); + cardView.setFocusableInTouchMode(true); + return new ViewHolder(cardView); +} +</pre> + +<p>When the user selects the {@link android.support.v17.leanback.widget.ImageCardView}, it expands +to reveal its text area with the background color you specify, as shown in figure 2.</p> + +<img itemprop="image" src="{@docRoot}images/tv/card-view.png" alt="App card view"/> +<p class="img-caption"><b>Figure 2.</b> The <a href="https://github.com/googlesamples/androidtv-Leanback"> +Leanback sample app</a> image card view when selected.</p> + + diff --git a/docs/html/training/tv/playback/index.jd b/docs/html/training/tv/playback/index.jd index 5427d48..0e9c5ec 100644 --- a/docs/html/training/tv/playback/index.jd +++ b/docs/html/training/tv/playback/index.jd @@ -56,6 +56,9 @@ startpage=true <dd>Learn how to use the Leanback support library to build a browsing interface for media catalogs.</dd> + <dt><b><a href="details.html">Providing a Card View</a></b></dt> + <dd>Learn how to use the Leanback support library to build a card view for content items.</dd> + <dt><b><a href="details.html">Building a Details View</a></b></dt> <dd>Learn how to use the Leanback support library to build a details page for media items.</dd> diff --git a/docs/html/training/tv/start/layouts.jd b/docs/html/training/tv/start/layouts.jd index 177ea7a..a378096 100644 --- a/docs/html/training/tv/start/layouts.jd +++ b/docs/html/training/tv/start/layouts.jd @@ -119,8 +119,8 @@ trainingnavtop=true <p> Avoid screen elements being clipped due to overscan and by incorporating a 10% margin - on all sides of your layout. This translates into a 27dp margin on the left and right edges and - a 48dp margin on the top and bottom of your base layouts for activities. The following + on all sides of your layout. This translates into a 48dp margin on the left and right edges and + a 27dp margin on the top and bottom of your base layouts for activities. The following example layout demonstrates how to set these margins in the root layout for a TV app: </p> |
