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