Android TV开发之卡片视图

在上一篇文章中，我们利用BrowseSupportFragment创建了一个目录浏览器，其中显示了一个媒体项列表。在本课中，您将为媒体项创建卡片视图(ImageCardView)，并在BrowseSupportFragment中呈现它们。
BaseCardView 类及其子类显示与媒体项关联的元数据。本文中使用的 ImageCardView 类可显示内容的图像以及媒体项的标题。
本课中所介绍的代码来自 Android TV GitHub 代码库中的 Android Leanback 示例应用。您可借助此示例代码开始编写自己的应用。

图 1. 选中后的 Leanback 示例应用图像卡片视图。

创建卡片 Presenter

Presenter 生成视图并根据需要为视图绑定对象。在应用向用户呈现内容的浏览 Fragment 中，您可以为内容卡片创建一个 Presenter，并将其传递给将内容添加到屏幕的 Adapter。在以下代码中，在 LoaderManager 的 onLoadFinished() 回调中创建了 CardPresenter。

    @Override
    public void onLoadFinished(Loader<HashMap<String, List<Movie>>> arg0,
                               HashMap<String, List<Movie>> data) {

        rowsAdapter = 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());
            i++;
            rowsAdapter.add(new ListRow(header, listRowAdapter));
        }

        HeaderItem gridHeader = new HeaderItem(i, getString(R.string.more_samples));

        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));
        rowsAdapter.add(new ListRow(gridHeader, gridRowAdapter));

        setAdapter(rowsAdapter);

        updateRecommendations();
    }

创建卡片视图

在此步骤中，您将为描述媒体内容项的卡片视图构建卡片 Presenter 及视图 Holder。请注意，每个 Presenter 仅可创建一种类型的视图。如果您有两种不同类型的卡片视图，您将需要两个不同的卡片 Presenter。
在 Presenter 回调来创建可用于显示内容项的视图 Holder。

    @Override
    public class CardPresenter extends Presenter {

        private Context context;
        private static int CARD_WIDTH = 313;
        private static int CARD_HEIGHT = 176;
        private Drawable defaultCardImage;

        @Override
        public ViewHolder onCreateViewHolder(ViewGroup parent) {
            context = parent.getContext();
            defaultCardImage = context.getResources().getDrawable(R.drawable.movie);
    ...

在 onCreateViewHolder() 方法中，为内容项创建一个卡片视图。以下示例使用了 ImageCardView。
当选中一张卡片时，默认行为会将它展开为更大的尺寸。如果您想为选定的卡片指定不同的颜色，请按照如下代码所示调用 setSelected()。

    ...
        ImageCardView cardView = new ImageCardView(context) {
            @Override
            public void setSelected(boolean selected) {
                int selected_background = context.getResources().getColor(R.color.detail_background);
                int default_background = context.getResources().getColor(R.color.default_background);
                int color = selected ? selected_background : default_background;
                findViewById(R.id.info_field).setBackgroundColor(color);
                super.setSelected(selected);
            }
        };
    ...

当用户打开您的应用时，Presenter.ViewHolder 会显示内容项的 CardView 对象。您需要通过调用 setFocusable(true) 和 setFocusableInTouchMode(true) 来设置这些对象，使其从方向键控制器接收焦点。

    ...
        cardView.setFocusable(true);
        cardView.setFocusableInTouchMode(true);
        return new ViewHolder(cardView);
    }

当用户选择 ImageCardView 时，它会展开以显示其文本区域（该区域以您指定的颜色为背景颜色），如图 1 所示。

这里需要解释下ArrayObjectAdapter、Presenter、数据源和ImageCardView之间的关系。

ArrayObjectAdapter其实就是对一组数据源进行管理，例如添加、更新等；
-Presenter创建Item的视图，这里是ImageCardView，并将数据源与视图进行绑定；
Presenter必须作为ArrayObjectAdapter构造方法的参数，这样Presenter才能根据ArrayObjectAdapter添加的数据源生成对应的视图

本文主要介绍了如何利用ImageCardView、Presenter和ArrayObjectAdapter显示媒体列表，下一篇介绍利用DetailsSupportFragment显示媒体详细信息。