מחלקות ממשק הגלישה במדיה שמסופקות על ידי ספריית androidx.leanback כוללים מחלקות להצגת מידע נוסף על פריט מדיה, כמו תיאור או ביקורות. הם גם כוללים הנחיות לביצוע פעולות לגבי הפריט, כמו רכישת הפריט או הפעלת התוכן שלו.
במדריך הזה מוסבר איך ליצור כיתה להצגת מצגות כדי לקבל פרטים על פריטי מדיה ואיך להרחיב את הכיתה
המחלקה DetailsSupportFragment
כדי להטמיע תצוגת פרטים
עבור פריט מדיה כשהמשתמש בוחר בו.
הערה: הדוגמה להטמעה שמוצגת כאן מתבססת על פעילות נוספת כדי
מכילים את DetailsSupportFragment
. עם זאת, ייתכן
להימנע מיצירת פעילות שנייה על ידי החלפת BrowseSupportFragment
בDetailsSupportFragment
בתוך אותה פעילות באמצעות
עסקאות במקטעים. למידע נוסף על השימוש בטרנזקציות עם מקטעים, ראו יצירת מקטע.
בניית מציג פרטים
במסגרת הגלישה במדיה שמסופקת על ידי ערכת הכלים של ממשק המשתמש ל-Leanback, עליך להשתמש במציג
אובייקטים כדי לשלוט בהצגת נתונים על המסך, כולל פרטי פריט מדיה.
למטרה הזו, המסגרת
מספק את AbstractDetailsDescriptionPresenter
סיווג, שהוא יישום כמעט מלא של המציג עבור פריט מדיה
פרטים. כל מה שצריך לעשות הוא להטמיע את onBindDescription()
לקישור של שדות התצוגה לאובייקטים של הנתונים, כפי שמוצג
דוגמת הקוד הבאה:
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."); } }
הרחבת מקטע הפרטים
כשמשתמשים במחלקה DetailsSupportFragment
להצגה
את פרטי פריט המדיה, מרחיבים את הכיתה כדי לספק תוכן נוסף, כמו תצוגה מקדימה.
התמונה והפעולות של פריט המדיה. תוכלו גם לספק תוכן נוסף, כמו רשימה של
ופריטי מדיה קשורים.
הקוד לדוגמה הבא מדגים איך להשתמש בכיתה של 'מציג'. הקטע הקודם כדי להוסיף תמונת תצוגה מקדימה ופעולות עבור פריט המדיה שמוצג. הדוגמה הזו מציגה גם שורה של פריטי מדיה קשורים, שמופיעה מתחת לרישום הפרטים.
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); } }
יצירת פעילות של פרטים
מקטעים כמו DetailsSupportFragment
חייבים להיות כלולים
בתוך פעילות שתשמש להצגה. יצירת פעילות לפרטים שלך
בתצוגת הפרטים - בנפרד מפעילות העיון - מאפשרת לך להפעיל את תצוגת הפרטים באמצעות
Intent
הזה
שמסביר איך ליצור פעילות שתכיל את ההטמעה של תצוגת הפרטים
פריטי המדיה שלך.
ליצור את פעילות הפרטים על ידי יצירת פריסה שמתייחסת להטמעת של
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" />
בשלב הבא, יוצרים סיווג פעילות שמבוסס על הפריסה שהוצגה בדוגמת הקוד הקודמת:
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); } }
בסוף, מוסיפים את הפעילות החדשה למניפסט. אל תשכחו להחיל את העיצוב של Leanback כדי לוודא שממשק המשתמש תואם לפעילות הגלישה במדיה.
<application> ... <activity android:name=".DetailsActivity" android:exported="true" android:theme="@style/Theme.Leanback"/> </application>
הגדרת האזנה לפריטים שלחצו עליהם
אחרי שמטמיעים את DetailsSupportFragment
,
לשנות את תצוגת הגלישה הראשית במדיה כדי לעבור לתצוגת הפרטים כשמשתמש לוחץ על מדיה
שימושי. כדי להפעיל את ההתנהגות הזו, צריך להוסיף
אובייקט OnItemViewClickedListener
אל
BrowseSupportFragment
שמפעיל כוונה להפעיל את הפריט
פרטי הפעילות.
הדוגמה הבאה מראה איך להטמיע האזנה כדי להפעיל את תצוגת הפרטים כשמשתמש לוחץ על פריט מדיה בפעילות הגלישה הראשית במדיה:
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); } }); } }