android tv 开发布局,Android TV开发之构建详情视图

本文介绍如何为媒体项目详情创建 Presenter 类，以及如何通过扩展 DetailsSupportFragment 类在用户选择媒体项目时为项目实现详情视图。

构建详情 Presenter

在 Leanback 支持库提供的媒体浏览框架中，您可以使用 Presenter 对象控制数据(包括媒体项目详情)在屏幕上的显示。该框架为此提供了 AbstractDetailsDescriptionPresenter 类，该类几乎是对媒体项目详情 Presenter 的完整实现。您只需实现 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.");

}

}

扩展DetailsSupportFragment

在使用 DetailsSupportFragment 类来显示您的媒体项目详情时，请扩展该类以提供媒体项目的预览图片和相关操作。您还可以提供其他内容，如相关媒体项目的列表。

以下示例代码演示了如何利用上一部分中显示的 Presenter 类为正在查看的媒体项目添加预览图片和相关操作。此示例还展示了如何添加相关媒体项目行，该行显示在详情列表下方。

public class MediaItemDetailsFragment extends DetailsSupportFragment {

private static final String TAG = "MediaItemDetailsFragment";

private ArrayObjectAdapter rowsAdapter;

@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());

rowsAdapter = 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"));

rowsAdapter.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);

rowsAdapter.add(new ListRow(header, listRowAdapter));

setAdapter(rowsAdapter);

}

}

创建详情 Activity

诸如 DetailsSupportFragment 之类的 Fragment 必须包含在 Activity 内，才能用于显示。您应该为详情视图创建一个 Activity，让其独立于浏览 Activity，这样便可以使用 Intent 来调用详情视图。本部分说明如何构建一个 Activity 来容纳您对媒体项目详情视图的实现。

创建详情 Activity 时，首先要构建一个引用 DetailsSupportFragment 实现的布局：

android:name="com.example.android.mediabrowser.MediaItemDetailsFragment"

android:id="@+id/details_fragment"

android:layout_width="match_parent"

android:layout_height="match_parent"

/>

接下来，创建一个使用上一代码示例中所示布局的 Activity 类：

public class DetailsActivity extends FragmentActivity

{

@Override

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.details);

}

}

最后，将这个新 Activity 添加到清单中。请记得应用 Leanback 主题背景，以确保界面与媒体浏览 Activity 保持一致：

...

android:exported="true"

android:theme="@style/Theme.Leanback"/>

为点击的项目定义监听器

在实现 DetailsSupportFragment 后，请将您的主媒体浏览视图修改为在用户点击媒体项目时切换到详情视图。为启用此行为，请将一个 OnItemViewClickedListener 对象添加到 BrowseSupportFragment 中，以便触发启动项目详情 Activity 的 intent。

以下示例展示了如何实现一个可在用户点击主媒体浏览 Activity 中的某个媒体项目时启动详情视图的监听器：

public class BrowseMediaActivity extends FragmentActivity {

...

@Override

protected void onCreate(Bundle savedInstanceState) {

...

// create the media item rows

buildRowsAdapter();

// add a listener for selected items

browseFragment.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);

}

});

}

}

至此，我们学习了如何实现AbstractDetailsDescriptionPresenter类用于显示媒体的详细信息，也学习如何扩展DetailsSupportFragment类将DetailsOverviewRow、FullWidthDetailsOverviewRowPresenter、DetailsDescriptionPresenter结合起来，实现最终的界面效果。