创建详情页

编写:huanglizhuo - 原文:<http://developer.android.com/training/tv/playback/details.html>

待认领进行编写，有意向的小伙伴，可以直接修改对应的markdown文件，进行提交！

v17 leanback support library 库提供的媒体浏览接口包含显示附加媒体信息的类,比如描述和预览,以及对项目的操作,比如购买或播放。

这节课讨论如何为媒体项目的详细信息创建 presenter 类，以及用户选择一个媒体项目时如何扩展 DetailsFragment类来实现显示媒体详细信息视图。

小贴士: 这里的实现例子用的是包含 DetailsFragment的附加activity。但也可以在同一个 activity 中用 fragment 转换将 BrowseFragment替换为 DetailsFragment.更多关于fragment的信息请参考Building a Dynamic UI with Fragments

创建详细Presenter

在leanback库提供的媒体浏览框架中,可以用presenter对象控制屏幕显示数据,包括媒体详细信息。AbstractDetailsDescriptionPresenter 类提供的框架几乎是媒体项目详细信息的完全继承。我们只需要实现onBindDescription()方法,像下面这样把数据信息和视图绑定起来。

1. public class DetailsDescriptionPresenter
2. extends AbstractDetailsDescriptionPresenter {

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

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

扩展详细fragment

当使用 DetailsFragment类显示我们的媒体项目详细信息时,扩展该类并提供像预览图片,操作等附加内容。我们也可以提供一系列的相关媒体信息。

下面的例子演示了怎样用presenter类为媒体项目添加预览图片和操作。这个例子也演示了添加相关媒体行。

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

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

10. buildDetails();
11. }

13. private void buildDetails() {
14. ClassPresenterSelector selector = new ClassPresenterSelector();
15. // Attach your media item details presenter to the row presenter:
16. DetailsOverviewRowPresenter rowPresenter =
17. new DetailsOverviewRowPresenter(new DetailsDescriptionPresenter());

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

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

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

34. // Add a Related items row
35. ArrayObjectAdapter listRowAdapter = new ArrayObjectAdapter(
36. new StringPresenter());
37. listRowAdapter.add("Media Item 1");
38. listRowAdapter.add("Media Item 2");
39. listRowAdapter.add("Media Item 3");
40. HeaderItem header = new HeaderItem(0, "Related Items", null);
41. mRowsAdapter.add(new ListRow(header, listRowAdapter));

43. setAdapter(mRowsAdapter);
44. }
45. }

创建详细信息activity

像 DetailsFragment这样的 fragment 为了使用或显示必须包含activity。为我们的详细信息与浏览分开创建activity并通过传递Intent打开。这节演示了如何创建一个包含媒体详细信息的activity。

创建详细信息前先为 DetailsFragment创建一个布局文件:

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

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

接下来用上面的布局文件创建一个activity:

1. public class DetailsActivity extends Activity
2. {
3. @Override
4. public void onCreate(Bundle savedInstanceState) {
5. super.onCreate(savedInstanceState);
6. setContentView(R.layout.details);
7. }
8. }

最后在manifest文件中申明activity。记得添加Leanback主题以确保用户界面中有媒体浏览activity。

1. <application>
2. ...

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

8. </application>

为点击项目添加Listener

实现 DetailsFragment后,在用户点击媒体条目时将我们的媒体浏览view切换详细信息view。为了确保动作的实现,在BrowserFragment中添加[OnItemViewClickedListener]通过Intent开启详细信息activity。

下面的例子演示了实现怎样在媒体浏览view中实现一个 listener开启详细信息view。

1. public class BrowseMediaActivity extends Activity {
2. ...

4. @Override
5. protected void onCreate(Bundle savedInstanceState) {
6. ...

8. // create the media item rows
9. buildRowsAdapter();

11. // add a listener for selected items
12. mBrowseFragment.OnItemViewClickedListener(
13. new OnItemViewClickedListener() {
14. @Override
15. public void onItemClicked(Object item, Row row) {
16. System.out.println("Media Item clicked: " + item.toString());
17. Intent intent = new Intent(BrowseMediaActivity.this,
18. DetailsActivity.class);
19. // pass the item information
20. intent.getExtras().putLong("id", item.getId());
21. startActivity(intent);
22. }
23. });
24. }
25. }

下一节：显示正在播放卡片 >