androidx.leanback kitaplığı tarafından sağlanan medyaya göz atma arayüzü sınıfları, açıklama veya yorumlar gibi medya öğesiyle ilgili ek bilgileri görüntülemek için kullanılan sınıflar içerir. Ayrıca, ürün satın alma veya içeriğini oynatma gibi işlemler yapmaya yönelik dersler de içerir.
Bu kılavuzda, medya öğesi ayrıntıları için sunucu sınıfının nasıl oluşturulacağı ve kullanıcı seçtiği medya öğesinin ayrıntılar görünümünü uygulamak için DetailsSupportFragment
sınıfının nasıl genişletileceği anlatılmaktadır.
Not: Burada gösterilen uygulama örneğinde, DetailsSupportFragment
parametresini içeren ek bir etkinlik kullanılmaktadır. Bununla birlikte, parça işlemleri kullanıp aynı etkinlik içinde BrowseSupportFragment
öğesini bir DetailsSupportFragment
ile değiştirerek ikinci bir etkinlik oluşturmaktan kaçınmak mümkündür. Parça işlemleri hakkında daha fazla bilgi için Parça oluşturma konusuna bakın.
Bir ayrıntı sunucusu oluşturma
Leanback kullanıcı arayüzü araç seti tarafından sağlanan medyaya göz atma çerçevesinde, medya öğesi ayrıntıları da dahil olmak üzere verilerin ekranda nasıl görüneceğini kontrol etmek için sunucu nesnelerini kullanırsınız.
Çerçeve bu amaçla AbstractDetailsDescriptionPresenter
sınıfını sağlar. Bu sınıf, medya öğesi ayrıntıları için sunucunun neredeyse eksiksiz bir şekilde uygulanmasıdır. Tek yapmanız gereken, aşağıdaki kod örneğinde gösterildiği gibi görünüm alanlarını veri nesnelerinize bağlamak için onBindDescription()
yöntemini uygulamaktır:
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."); } }
Ayrıntı parçasını genişlet
Medya öğesi ayrıntılarınızı görüntülemek için DetailsSupportFragment
sınıfını kullanırken bu sınıfı, medya öğesi için önizleme resmi ve işlemler gibi ek içerik sağlayacak şekilde genişletin. Ayrıca ilgili medya öğelerinin listesi gibi ek içerikler de sağlayabilirsiniz.
Aşağıdaki örnek kod, görüntülenen medya öğesi için önizleme resmi ve işlemler eklemek üzere önceki bölümde gösterilen sunucu sınıfının nasıl kullanılacağını gösterir. Bu örnekte, ayrıntılar girişinin altında görünen ilgili medya öğeleri satırının eklenmesi de gösterilmektedir.
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); } }
Ayrıntı etkinliği oluştur
DetailsSupportFragment
gibi parçalar, görüntüleme amacıyla kullanılacak bir etkinlik içinde yer almalıdır. Ayrıntılar görünümünüz için göz atma etkinliğinden ayrı bir etkinlik oluşturmak, Intent
kullanarak ayrıntılar görünümünü çağırmanıza olanak tanır. Bu bölümde, medya öğelerinizin ayrıntı görünümü uygulamanızı dahil etmek için nasıl etkinlik oluşturabileceğiniz açıklanmaktadır.
DetailsSupportFragment
uygulamanıza referans veren bir düzen oluşturarak ayrıntılar etkinliğini oluşturun:
<!-- 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" />
Ardından, önceki kod örneğinde gösterilen düzeni kullanan bir etkinlik sınıfı oluşturun:
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); } }
Son olarak, bu yeni etkinliği manifest dosyasına ekleyin. Kullanıcı arayüzünün medya göz atma etkinliğiyle tutarlı olduğundan emin olmak için Leanback temasını uygulamayı unutmayın.
<application> ... <activity android:name=".DetailsActivity" android:exported="true" android:theme="@style/Theme.Leanback"/> </application>
Tıklanan öğeler için bir işleyici tanımlayın
DetailsSupportFragment
öğesini uyguladıktan sonra,
bir kullanıcı bir medya öğesini tıkladığında ana medya tarama görünümünüzü ayrıntılar görünümüne geçecek şekilde
değiştirin. Bu davranışı etkinleştirmek için BrowseSupportFragment
öğesine, öğe ayrıntıları etkinliğini başlatma niyetini tetikleyen bir OnItemViewClickedListener
nesnesi ekleyin.
Aşağıdaki örnekte, bir kullanıcı ana medya tarama etkinliğindeki bir medya öğesini tıkladığında ayrıntılar görünümünü başlatmak için işleyicinin nasıl uygulanacağı gösterilmektedir:
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); } }); } }