Android Studio V3.12环境下TV开发教程

（转自Android官网https://developer.android.com/training/tv/start）

文章源自：光谷佳武 https://blog.csdn.net/jiawuhan/article/details/80620174

建立详细信息视图

v17 leanback支持库提供的媒体浏览界面类包括用于显示有关媒体项目的附加信息（如描述或评论）以及对该项目采取措施（如购买或播放其内容）的类。

本课讨论如何为媒体项目详细信息创建演示者类，以及如何在用户选择媒体项目时扩展DetailsFragment类以实现媒体项目的详细信息视图。

注意：此处显示的实现示例使用额外的活动来包含DetailsFragment 。但是，可以避免通过使用片段事务将当前的BrowseFragment替换为同一活动内的BrowseFragment来创建第二个活动。有关使用片段事务的更多信息，请参阅使用片段训练构建动态UI 。

建立一个细节主持人

在leanback库提供的媒体浏览框架中，您使用演示者对象来控制屏幕上的数据显示，包括媒体项目详细信息。该框架为此提供了AbstractDetailsDescriptionPresenter类，这是演示者对媒体项目详细信息的几乎完整的实现。您只需实现onBindDescription()方法将视图字段绑定到数据对象，如下面的代码示例所示：

public class DetailsDescriptionPresenter
        extends AbstractDetailsDescriptionPresenter {

    @Override
    protected void onBindDescription(ViewHolder viewHolder, Object itemData) {
        MyMediaItemDetails details = (MyMediaItemDetails) itemData;
        // In a production app, the itemData object contains the information
        // needed to display details for the media item:
        // viewHolder.getTitle().setText(details.getShortTitle());

        // Here we provide static data for testing purposes:
        viewHolder.getTitle().setText(itemData.toString());
        viewHolder.getSubtitle().setText("2014   Drama   TV-14");
        viewHolder.getBody().setText("Lorem ipsum dolor sit amet, consectetur "
                + "adipisicing elit, sed do eiusmod tempor incididunt ut labore "
                + " et dolore magna aliqua. Ut enim ad minim veniam, quis "
                + "nostrud exercitation ullamco laboris nisi ut aliquip ex ea "
                + "commodo consequat.");
    }
}

扩展细节片段

使用DetailsFragment类显示媒体项目详细信息时，请扩展该类以提供其他内容，例如预览图像和媒体项目的操作。您还可以提供其他内容，例如相关媒体项目的列表。

以下示例代码演示了如何使用前一节中显示的演示者类来为正在查看的媒体项目添加预览图像和操作。此示例还显示了相关媒体项行的添加，该行显示在详细信息列表下方。

public class MediaItemDetailsFragment extends DetailsFragment {
    private static final String TAG = "MediaItemDetailsFragment";
    private ArrayObjectAdapter mRowsAdapter;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        Log.i(TAG, "onCreate");
        super.onCreate(savedInstanceState);

        buildDetails();
    }

    private void buildDetails() {
        ClassPresenterSelector selector = new ClassPresenterSelector();
        // Attach your media item details presenter to the row presenter:
        FullWidthDetailsOverviewRowPresenter rowPresenter =
            new FullWidthDetailsOverviewRowPresenter(
                new DetailsDescriptionPresenter());

        selector.addClassPresenter(DetailsOverviewRow.class, rowPresenter);
        selector.addClassPresenter(ListRow.class,
                new ListRowPresenter());
        mRowsAdapter = new ArrayObjectAdapter(selector);

        Resources res = getActivity().getResources();
        DetailsOverviewRow detailsOverview = new DetailsOverviewRow(
                "Media Item Details");

        // Add images and action buttons to the details view
        detailsOverview.setImageDrawable(res.getDrawable(R.drawable.jelly_beans));
        detailsOverview.addAction(new Action(1, "Buy $9.99"));
        detailsOverview.addAction(new Action(2, "Rent $2.99"));
        mRowsAdapter.add(detailsOverview);

        // Add a Related items row
        ArrayObjectAdapter listRowAdapter = new ArrayObjectAdapter(
                new StringPresenter());
        listRowAdapter.add("Media Item 1");
        listRowAdapter.add("Media Item 2");
        listRowAdapter.add("Media Item 3");
        HeaderItem header = new HeaderItem(0, "Related Items", null);
        mRowsAdapter.add(new ListRow(header, listRowAdapter));

        setAdapter(mRowsAdapter);
    }
}

创建一个细节活动

片段（如DetailsFragment必须包含在一个活动中才能用于显示。为您的详细信息视图创建一个活动，与浏览活动分开，使您可以使用Intent调用您的详细信息视图。本节介绍如何构建一个活动来包含您的媒体项目的详细视图实现。

通过构建引用您的DetailsFragment实现的布局来开始创建细节活动：

<!-- file: res/layout/details.xml -->

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    android:name="com.example.android.mediabrowser.MediaItemDetailsFragment"
    android:id="@+id/details_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
/>

接下来，创建一个使用前面代码示例中显示的布局的活动类：

public class DetailsActivity extends Activity
{
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.details);
    }
}

最后，将这个新的活动添加到清单。请记住应用Leanback主题以确保用户界面与媒体浏览活动一致：

<application>
  ...

  <activity android:name=".DetailsActivity"
    android:exported="true"
    android:theme="@style/Theme.Leanback"/>

</application>

为点击的项目定义一个侦听器

在实现了DetailsFragment ，修改主媒体浏览视图以在用户单击媒体项目时移至您的详细信息视图。为了启用此行为，请将一个OnItemViewClickedListener对象添加到OnItemViewClickedListener ，该对象触发了启动项目详细信息活动的意图。

以下示例显示了如何在用户单击主媒体浏览活动中的媒体项时实现侦听器以启动详细信息视图：

public class BrowseMediaActivity extends Activity {
    ...

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...

        // create the media item rows
        buildRowsAdapter();

        // add a listener for selected items
        mBrowseFragment.OnItemViewClickedListener(
            new OnItemViewClickedListener() {
                @Override
                public void onItemClicked(Object item, Row row) {
                    System.out.println("Media Item clicked: " + item.toString());
                    Intent intent = new Intent(BrowseMediaActivity.this,
                            DetailsActivity.class);
                    // pass the item information
                    intent.getExtras().putLong("id", item.getId());
                    startActivity(intent);
                }
            });
    }
}