นำเสนอมุมมองการ์ด

สร้างได้ดียิ่งขึ้นด้วย Compose

สร้าง UI ที่สวยงามด้วยโค้ดแบบเรียบง่ายโดยใช้ Jetpack Compose สำหรับระบบปฏิบัติการ Android TV

Compose สำหรับรายการทีวี →

ในบทเรียนก่อนหน้านี้ คุณได้สร้างเบราว์เซอร์แคตตาล็อก ซึ่งนำไปใช้ในส่วนการเรียกดู แสดงรายการสื่อ ในบทเรียนนี้ คุณสร้างมุมมองการ์ดสำหรับรายการสื่อและ ให้แสดงในส่วนการเรียกดู

BaseCardView คลาสและคลาสย่อยจะแสดงข้อมูลเมตาที่เชื่อมโยงกับรายการสื่อ ImageCardView คลาสที่ใช้ในบทเรียนนี้จะแสดงรูปภาพสำหรับเนื้อหาพร้อมกับชื่อรายการสื่อ

และดูตัวอย่างการติดตั้งใช้งานใน แอปตัวอย่าง Leanback ที่ใช้เวลาเพียง 2 นาที

รูปที่ 1 มุมมองการ์ดรูปภาพแอปตัวอย่าง Leanback เมื่อเลือก

สร้างผู้นำเสนอการ์ด

Presenter สร้างมุมมองและเชื่อมโยงออบเจ็กต์กับมุมมอง ได้แบบออนดีมานด์ ในส่วนการเรียกดูที่แอปของคุณนำเสนอเนื้อหาของแอปแก่ผู้ใช้ คุณต้องสร้าง Presenterสำหรับการ์ดเนื้อหาและส่งไปยังอะแดปเตอร์ เพื่อเพิ่มเนื้อหาลงในหน้าจอ ในโค้ดต่อไปนี้ ระบบสร้าง CardPresenter ขึ้น ในช่วงonLoadFinished() Callback ของ LoaderManager:

Kotlin

override fun onLoadFinished(loader: Loader<HashMap<String, List<Movie>>>, data: HashMap<String, List<Movie>>) {
    rowsAdapter = ArrayObjectAdapter(ListRowPresenter())
    val cardPresenter = CardPresenter()

    var i = 0L

    data.entries.forEach { entry ->
        val listRowAdapter = ArrayObjectAdapter(cardPresenter).apply {
            entry.value.forEach { movie ->
                add(movie)
            }
        }

        val header = HeaderItem(i, entry.key)
        i++
        rowsAdapter.add(ListRow(header, listRowAdapter))
    }

    val gridHeader = HeaderItem(i, getString(R.string.more_samples))

    val gridRowAdapter = ArrayObjectAdapter(GridItemPresenter()).apply {
        add(getString(R.string.grid_view))
        add(getString(R.string.error_fragment))
        add(getString(R.string.personal_settings))
    }
    rowsAdapter.add(ListRow(gridHeader, gridRowAdapter))

    adapter = rowsAdapter

    updateRecommendations()
}

Java

@Override
public void onLoadFinished(Loader<HashMap<String, List<Movie>>> arg0,
                           HashMap<String, List<Movie>> data) {

    rowsAdapter = new ArrayObjectAdapter(new ListRowPresenter());
    CardPresenter cardPresenter = new CardPresenter();

    int i = 0;

    for (Map.Entry<String, List<Movie>> entry : data.entrySet()) {
        ArrayObjectAdapter listRowAdapter = new ArrayObjectAdapter(cardPresenter);
        List<Movie> list = entry.getValue();

        for (int j = 0; j < list.size(); j++) {
            listRowAdapter.add(list.get(j));
        }
        HeaderItem header = new HeaderItem(i, entry.getKey());
        i++;
        rowsAdapter.add(new ListRow(header, listRowAdapter));
    }

    HeaderItem gridHeader = new HeaderItem(i, getString(R.string.more_samples));

    GridItemPresenter gridPresenter = new GridItemPresenter();
    ArrayObjectAdapter gridRowAdapter = new ArrayObjectAdapter(gridPresenter);
    gridRowAdapter.add(getString(R.string.grid_view));
    gridRowAdapter.add(getString(R.string.error_fragment));
    gridRowAdapter.add(getString(R.string.personal_settings));
    rowsAdapter.add(new ListRow(gridHeader, gridRowAdapter));

    setAdapter(rowsAdapter);

    updateRecommendations();
}

สร้างมุมมองการ์ด

ในขั้นตอนนี้ คุณจะต้องสร้างผู้นำเสนอการ์ดโดยใช้ผู้ถือมุมมองสำหรับมุมมองการ์ดที่อธิบาย รายการเนื้อหาสื่อของคุณ โปรดทราบว่าผู้นำเสนอแต่ละคนจะต้องสร้างมุมมองเพียงประเภทเดียว ถ้าคุณมี 2 แบบ ประเภทมุมมองการ์ด คุณต้องมีผู้นำเสนอการ์ด 2 ราย

ใน Presenter ให้ใช้ วันที่ onCreateViewHolder() Callback ที่สร้างตัวยึดตำแหน่งที่ใช้ในการแสดงรายการเนื้อหาได้

Kotlin

private const val CARD_WIDTH = 313
private const val CARD_HEIGHT = 176

class CardPresenter : Presenter() {

    private lateinit var mContext: Context
    private lateinit var defaultCardImage: Drawable

    override fun onCreateViewHolder(parent: ViewGroup): Presenter.ViewHolder {
        mContext = parent.context
        defaultCardImage = mContext.resources.getDrawable(R.drawable.movie)
        ...

Java

@Override
public class CardPresenter extends Presenter {

    private Context context;
    private static int CARD_WIDTH = 313;
    private static int CARD_HEIGHT = 176;
    private Drawable defaultCardImage;

    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent) {
        context = parent.getContext();
        defaultCardImage = context.getResources().getDrawable(R.drawable.movie);
...

ในเมธอด onCreateViewHolder() สร้างมุมมองการ์ด สำหรับรายการเนื้อหา ตัวอย่างต่อไปนี้ใช้ ImageCardView

เมื่อเลือกการ์ดแล้ว ลักษณะการทำงานเริ่มต้นจะขยายการ์ดให้มีขนาดใหญ่ขึ้น หากต้องการกำหนด การ์ดที่เลือกสีอื่น โทรหา setSelected() ดังที่แสดงที่นี่

Kotlin

    ...
    val cardView = object : ImageCardView(context) {
        override fun setSelected(selected: Boolean) {
            val selected_background = context.resources.getColor(R.color.detail_background)
            val default_background = context.resources.getColor(R.color.default_background)
            val color = if (selected) selected_background else default_background
            findViewById<View>(R.id.info_field).setBackgroundColor(color)
            super.setSelected(selected)
        }
    }
    ...

Java

...
    ImageCardView cardView = new ImageCardView(context) {
        @Override
        public void setSelected(boolean selected) {
            int selected_background = context.getResources().getColor(R.color.detail_background);
            int default_background = context.getResources().getColor(R.color.default_background);
            int color = selected ? selected_background : default_background;
            findViewById(R.id.info_field).setBackgroundColor(color);
            super.setSelected(selected);
        }
    };
...

เมื่อผู้ใช้เปิดแอป Presenter.ViewHolder แสดงออบเจ็กต์ CardView สำหรับรายการเนื้อหาของคุณ คุณต้องตั้งค่ารายการเหล่านี้เพื่อรับ โฟกัสจากตัวควบคุม D-pad โดยโทรหา setFocusable(true) และ setFocusableInTouchMode(true) ดังที่แสดงในรหัสต่อไปนี้

Kotlin

    ...
    cardView.isFocusable = true
    cardView.isFocusableInTouchMode = true
    return ViewHolder(cardView)
}

Java

...
    cardView.setFocusable(true);
    cardView.setFocusableInTouchMode(true);
    return new ViewHolder(cardView);
}

เมื่อผู้ใช้เลือก ImageCardView ปุ่มจะขยาย เพื่อแสดงพื้นที่ข้อความด้วยสีพื้นหลังที่คุณระบุ ดังแสดงในรูปที่ 1