Klasy interfejsu przeglądania multimediów udostępniane przez bibliotekę Leanback na Androidax obejmują klasy do wyświetlania dodatkowych informacji o elemencie multimedialnym, takich jak opis czy opinie. Obejmują one również klasyfikację wykonywania działań na rzecz danego elementu, na przykład jego zakupu lub odtwarzania treści.
Z tego przewodnika dowiesz się, jak utworzyć klasę prezentującą szczegóły elementu multimedialnego i rozszerzyć klasę DetailsSupportFragment, aby zaimplementować widok szczegółów elementu multimedialnego, gdy użytkownik go wybierze.
Uwaga: w przedstawionym tutaj przykładzie wdrożenia użyto dodatkowej aktywności do uwzględnienia funkcji DetailsSupportFragment. Można jednak uniknąć tworzenia drugiej aktywności, zastępując BrowseSupportFragment elementem DetailsSupportFragment w tej samej aktywności, używając transakcji fragmentowych. Więcej informacji o korzystaniu z transakcji opartych na fragmentach znajdziesz w artykule Tworzenie fragmentu.
Tworzenie prezentacji szczegółów
W ramach przeglądania multimediów udostępnianej przez bibliotekę funkcji TalkBack możesz używać obiektów prezentacji do kontrolowania wyświetlania danych na ekranie, w tym szczegółów elementów multimedialnych.
W tym celu platforma udostępnia klasę AbstractDetailsDescriptionPresenter, która jest prawie pełną implementacją prezentera dla szczegółów elementów multimedialnych. Musisz tylko wdrożyć metodę onBindDescription(), aby powiązać pola widoku z obiektami danych, jak 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 używasz klasy DetailsSupportFragment do wyświetlania szczegółów elementu multimedialnego, rozszerz tę klasę o dodatkowe treści, takie jak obraz podglądu i działania związane z elementem multimedialnym. Możesz też podać dodatkowe treści, np. listę powiązanych elementów multimedialnych.
Poniższy przykładowy kod pokazuje, jak użyć klasy prowadzącego z wyświetlonej w poprzedniej sekcji, aby dodać obraz podglądu i działania związane z wyświetlanym elementem multimedialnym. W tym przykładzie widać też dodanie wiersza powiązanych elementów multimedialnych, które jest widoczne 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);
}
}
Tworzenie działania związanego ze szczegółami
Aby można było wyświetlać fragmenty takie jak DetailsSupportFragment, muszą one znajdować się w ramach działania. Utworzenie działania dla widoku szczegółów – niezależnie od aktywności przeglądania – pozwala wywołać widok szczegółów za pomocą funkcji Intent. W tej sekcji dowiesz się, jak utworzyć działanie zawierające implementację widoku szczegółowego elementów multimedialnych.
Utwórz aktywność związaną ze szczegółami, tworząc układ, który odwołuje się do Twojej implementacji zasobu 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, aby zastosować motyw funkcji Suica, aby zapewnić spójność interfejsu z aktywnością przeglądania multimediów.
<application>
...
<activity android:name=".DetailsActivity"
android:exported="true"
android:theme="@style/Theme.Leanback"/>
</application>
Definiowanie odbiornika dla klikniętych elementów
Po zaimplementowaniu DetailsSupportFragment zmodyfikuj główny widok przeglądania multimediów, aby po kliknięciu elementu multimedialnego użytkownik przechodził do widoku szczegółów. Aby włączyć to zachowanie, dodaj do obiektu BrowseSupportFragment obiekt OnItemViewClickedListener, który uruchamia intencję rozpoczynania działania związanego ze szczegółami elementu.
Poniższy przykład pokazuje, jak wdrożyć detektor, aby uruchamiać widok szczegółów, gdy użytkownik kliknie element multimedialny w głównej aktywności związanej z przeglądaniem multimedió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);
}
});
}
}