Эта страница переведена с помощью Cloud Translation API.

Создание подробного представления

Классы интерфейса просмотра мультимедиа, предоставляемые библиотекой androidx.leanback, включают классы для отображения дополнительной информации об элементе мультимедиа, например описания или обзоров. Они также включают классы для действий с этим элементом, таких как покупка или воспроизведение его содержимого.

В этом руководстве описывается, как создать класс презентатора для сведений об элементе мультимедиа и как расширить класс DetailsSupportFragment для реализации представления сведений об элементе мультимедиа, когда пользователь его выбирает.

Примечание. Показанный здесь пример реализации использует дополнительное действие для хранения DetailsSupportFragment . Однако можно избежать создания второго действия, заменив BrowseSupportFragment на DetailsSupportFragment внутри того же действия, используя транзакции фрагментов. Дополнительные сведения об использовании транзакций фрагментов см. в разделе Создание фрагмента .

Создайте презентатор подробностей

В платформе просмотра мультимедиа, предоставляемой набором инструментов Leanback UI, вы используете объекты презентаторов для управления отображением данных на экране, включая сведения об элементах мультимедиа. Для этой цели платформа предоставляет класс AbstractDetailsDescriptionPresenter , который представляет собой почти полную реализацию презентатора для сведений об элементе мультимедиа. Все, что вам нужно сделать, это реализовать метод onBindDescription() для привязки полей представления к вашим объектам данных, как показано в следующем примере кода:

Котлин

class DetailsDescriptionPresenter : AbstractDetailsDescriptionPresenter() {

    override fun onBindDescription(viewHolder: AbstractDetailsDescriptionPresenter.ViewHolder, itemData: Any) {
        val details = itemData as MyMediaItemDetails
        // In a production app, the itemData object contains the information
        // needed to display details for the media item:
        // viewHolder.title.text = details.shortTitle

        // Here we provide static data for testing purposes:
        viewHolder.apply {
            title.text = itemData.toString()
            subtitle.text = "2014   Drama   TV-14"
            body.text = ("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.")
        }
    }
}

Ява

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 для отображения сведений об элементе мультимедиа расширьте этот класс, чтобы предоставить дополнительный контент, например изображение предварительного просмотра и действия для элемента мультимедиа. Вы также можете предоставить дополнительный контент, например список связанных медиа-элементов.

В следующем примере кода показано, как использовать класс презентатора, показанный в предыдущем разделе, для добавления изображения предварительного просмотра и действий для просматриваемого элемента мультимедиа. В этом примере также показано добавление строки связанных элементов мультимедиа, которая отображается под списком сведений.

Котлин

private const val TAG = "MediaItemDetailsFragment"

class MediaItemDetailsFragment : DetailsSupportFragment() {
    private lateinit var rowsAdapter: ArrayObjectAdapter

    override fun onCreate(savedInstanceState: Bundle?) {
        Log.i(TAG, "onCreate")
        super.onCreate(savedInstanceState)

        buildDetails()
    }

    private fun buildDetails() {
        val selector = ClassPresenterSelector().apply {
            // Attach your media item details presenter to the row presenter:
            FullWidthDetailsOverviewRowPresenter(DetailsDescriptionPresenter()).also {
                addClassPresenter(DetailsOverviewRow::class.java, it)
            }
            addClassPresenter(ListRow::class.java, ListRowPresenter())
        }
        rowsAdapter = ArrayObjectAdapter(selector)

        val res = activity.resources
        val detailsOverview = DetailsOverviewRow("Media Item Details").apply {

            // Add images and action buttons to the details view
            imageDrawable = res.getDrawable(R.drawable.jelly_beans)
            addAction(Action(1, "Buy $9.99"))
            addAction(Action(2, "Rent $2.99"))
        }
        rowsAdapter.add(detailsOverview)

        // Add a related items row
        val listRowAdapter = ArrayObjectAdapter(StringPresenter()).apply {
            add("Media Item 1")
            add("Media Item 2")
            add("Media Item 3")
        }
        val header = HeaderItem(0, "Related Items")
        rowsAdapter.add(ListRow(header, listRowAdapter))

        adapter = rowsAdapter
    }
}

Ява

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);
    }
}

Создайте подробное действие

Фрагменты, подобные DetailsSupportFragment должны содержаться внутри действия, которое будет использоваться для отображения. Создание активности для вашего представления подробностей — отдельно от активности просмотра — позволяет вам вызывать представление подробностей с помощью Intent . В этом разделе объясняется, как создать действие, содержащее реализацию подробного представления для ваших элементов мультимедиа.

Создайте действие Details, создав макет, который ссылается на вашу реализацию DetailsSupportFragment :

<!-- 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"
/>

Затем создайте класс активности, использующий макет, показанный в предыдущем примере кода:

Котлин

class DetailsActivity : FragmentActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.details)
    }
}

Ява

public class DetailsActivity extends FragmentActivity
{
    @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>

Определить прослушиватель для нажатых элементов

После реализации DetailsSupportFragment измените основное представление просмотра мультимедиа, чтобы оно переходило к представлению сведений, когда пользователь щелкает элемент мультимедиа. Чтобы включить это поведение, добавьте объект OnItemViewClickedListener в BrowseSupportFragment , который запускает намерение запустить действие сведений об элементе.

В следующем примере показано, как реализовать прослушиватель для запуска просмотра подробностей, когда пользователь щелкает элемент мультимедиа в основном действии просмотра мультимедиа:

Котлин

class BrowseMediaActivity : FragmentActivity() {
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        ...
        // Create the media item rows
        buildRowsAdapter()

        // Add a listener for selected items
        browseFragment.onItemViewClickedListener = OnItemViewClickedListener { _, item, _, _ ->
            println("Media Item clicked: ${item}")
            val intent = Intent(this@BrowseMediaActivity, DetailsActivity::class.java).apply {
                // Pass the item information
                extras.putLong("id", item.getId())
            }
            startActivity(intent)
        }
    }
}

Ява

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);
                }
            });
    }
}

Предоставить представление карты

Используйте средства управления транспортом