Klasy interfejsu przeglądania multimediów dostępne w bibliotece androidx.leanback zawierają klasy wyświetlające dodatkowe informacje o elemencie multimedialnym, takie jak opis czy opinie. Obejmuje to też zajęcia dotyczące wykonywania działań związanych z danym elementem, np. zakupu go lub odtwarzania jego treści.
Z tego przewodnika dowiesz się, jak utworzyć klasę prezentacji ze szczegółami elementu multimedialnego oraz jak rozszerzyć klasę DetailsSupportFragment
w celu zaimplementowania widoku szczegółów elementu multimedialnego po jego wybraniu przez użytkownika.
Uwaga: w pokazanym tutaj przykładzie implementacji użyto dodatkowej aktywności do umieszczenia DetailsSupportFragment
. Możesz jednak uniknąć tworzenia drugiej aktywności, zastępując BrowseSupportFragment
wartością DetailsSupportFragment
w tej samej aktywności za pomocą transakcji fragmentarycznych. Więcej informacji o korzystaniu z transakcji opartych na fragmentach znajdziesz w sekcji Tworzenie fragmentu.
Tworzenie prezentacji szczegółów
W ramach platformy przeglądania multimediów dostępnej w zestawie narzędzi interfejsu Leanback służą obiekty prowadzące do sterowania wyświetlaniem danych na ekranie, w tym szczegółów elementów multimedialnych.
W tym celu platforma udostępnia klasę AbstractDetailsDescriptionPresenter
, która jest niemal uśrednioną implementacją szczegółów elementu multimedialnego. Wystarczy, że zaimplementujesz metodę onBindDescription()
, by powiązać pola widoku z obiektami danych w sposób przedstawiony w tym przykładowym kodzie:
Kotlin
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.") } } }
Java
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."); } }
Rozszerz fragment szczegółów
Jeśli do wyświetlania szczegółów elementu multimedialnego używasz klasy DetailsSupportFragment
, rozszerz ją, aby udostępnić dodatkowe treści, takie jak obraz podglądu i działania dla tego elementu. Możesz też przesłać dodatkowe treści, np. listę powiązanych elementów multimedialnych.
Ten przykładowy kod pokazuje, jak użyć klasy prowadzącej pokazanej w poprzedniej sekcji, aby dodać obraz podglądu i działania dla wyświetlanego elementu multimedialnego. Ten przykład pokazuje też dodanie wiersza powiązanych elementów multimedialnych, który znajduje się pod listą szczegółów.
Kotlin
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 } }
Java
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); } }
Utwórz aktywność z informacjami
Fragmenty takie jak DetailsSupportFragment
muszą być zawarte w aktywności, aby można było ich używać do wyświetlania. Utworzenie działania dla widoku szczegółów – niezależnego od aktywności przeglądania – umożliwia wywoływanie widoku szczegółów za pomocą Intent
. W tej sekcji dowiesz się, jak utworzyć działanie obejmujące implementację widoku szczegółów elementów multimedialnych.
Utwórz aktywność szczegółów, tworząc układ, który odwołuje się do Twojej implementacji obiektu 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" />
Następnie utwórz klasę aktywności wykorzystującą układ pokazany w poprzednim przykładzie kodu:
Kotlin
class DetailsActivity : FragmentActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.details) } }
Java
public class DetailsActivity extends FragmentActivity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.details); } }
Na koniec dodaj tę nową aktywność do pliku manifestu. Pamiętaj o zastosowaniu motywu Leanback, aby mieć pewność, że interfejs użytkownika jest zgodny z aktywnością związaną z przeglądaniem multimediów.
<application> ... <activity android:name=".DetailsActivity" android:exported="true" android:theme="@style/Theme.Leanback"/> </application>
Zdefiniuj detektor klikanych elementów
Po zaimplementowaniu obiektu DetailsSupportFragment
zmodyfikuj główny widok przeglądania multimediów, aby po kliknięciu elementu multimedialnego przez użytkownika przechodził do widoku szczegółów. Aby włączyć to zachowanie, dodaj do BrowseSupportFragment
obiekt OnItemViewClickedListener
, który uruchamia intencję rozpoczynającą aktywność związaną ze szczegółami elementu.
Ten przykład pokazuje, jak zaimplementować detektor, aby po kliknięciu przez użytkownika elementu multimedialnego w ramach głównej aktywności związanej z przeglądaniem multimediów uruchamiał się widok szczegółów:
Kotlin
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) } } }
Java
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); } }); } }