Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Màn hình chính của Android TV hiển thị nội dung đề xuất bằng các kênh và
chương trình. Kênh được hiển thị dưới dạng hàng riêng lẻ trên màn hình chính, trong đó
các thẻ hiển thị tất cả chương trình có sẵn cho kênh đó.
Ứng dụng của bạn cần có ít nhất một kênh. Kênh đầu tiên của bạn
mà ứng dụng tạo ra sẽ trở thành kênh mặc định của nó,
và Android TV sẽ tự động hiển thị kênh đó trên màn hình chính. Ứng dụng của bạn
có thể cung cấp các kênh khác nhưng người dùng phải chọn và phê duyệt các kênh đó
trước khi thêm vào màn hình chính.
Nếu ứng dụng của bạn có chương trình truyền hình, phim hoặc nội dung video khác, chúng tôi khuyên bạn
bạn hỗ trợ bản xem trước video và
tích hợp với kênh Watch Next.
Kênh Watch Next do hệ thống Android kiểm soát. Ứng dụng của bạn có thể thêm
chương trình liên quan đến người dùng nào đến kênh này, chẳng hạn như các chương trình mà người dùng đã đánh dấu là
thú vị, đã dừng xem ở giữa hoặc có liên quan đến nội dung
người dùng đang xem (như tập tiếp theo trong loạt phim hoặc phần tiếp theo của
hiển thị).
Đảm bảo khả năng tương thích
Màn hình chính hiển thị các đề xuất theo hai cách khác nhau, tuỳ thuộc vào
phiên bản Android:
Trong Android 8.0 (API cấp 26) trở lên, các ứng dụng có thể cho thấy đề xuất ở một hoặc
thêm kênh xuất hiện trên các hàng riêng biệt. Một kênh (kênh mặc định)
luôn xuất hiện. Người dùng có thể khám phá và thêm các kênh khác vào trang chủ của họ
màn hình. Tìm hiểu cách tạo kênh đề xuất
trên màn hình chính.
Trước Android 8.0, Android TV hiển thị tất cả nội dung đề xuất trong một
hàng đề xuất luôn xuất hiện trên màn hình. Tìm hiểu cách tạo
hàng đề xuất trên trang chủ
màn hình.
Để có thể hiển thị nội dung đề xuất trên mọi phiên bản Android TV, ứng dụng của bạn
nên triển khai cả hai API đề xuất. Kiểm thử cấp độ API hiện tại của hệ thống và
sử dụng API thích hợp để tạo hàng hoặc kênh đề xuất.
Kotlin
if(android.os.Build.VERSION.SDK_INT>=Build.VERSION_CODES.O){// Use the home screen recommendation channels API}else{// Use the recommendations row API}
Java
if(android.os.Build.VERSION.SDK_INT>=Build.VERSION_CODES.O){// Use the home screen recommendation channels API}else{// Use the recommendations row API}
Nếu ứng dụng của bạn được biên dịch bằng API cấp 25 trở xuống, thì ứng dụng vẫn có thể chạy trên
Android TV ở cấp 26. Hành vi đề xuất cũ là tương thích chuyển tiếp,
nhưng bị hạn chế:
Hàng đề xuất được tự động chuyển đổi và xuất hiện dưới dạng một hàng mới
trên màn hình chính.
Các chương trình trên kênh đã chuyển đổi sẽ phản hồi thông tin cập nhật từ
dịch vụ đề xuất,
nhưng người dùng không thể sử dụng giao diện người dùng của TV để thao tác với các chương trình trên kênh
(thêm/xoá chương trình, sao chép chương trình vào kênh Watch Next).
Nếu bạn cập nhật ứng dụng lên API cấp 26 thì kênh được chuyển đổi
vẫn xuất hiện trên các TV chạy API 26. TV sẽ xoá kênh đã chuyển đổi khỏi
màn hình lần đầu tiên ứng dụng của bạn hiển thị một kênh được tạo bằng API mới.
Điều này xảy ra ngay lập tức nếu ứng dụng tạo một
kênh mặc định,
hoặc sau đó khi người dùng chọn và thêm bất kỳ kênh nào khác do ứng dụng của bạn tạo.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],null,["# Recommend content on the home screen\n\nThe Android TV *home screen* displays recommended content using *channels* and\n*programs*. Channels are displayed as individual rows on the home screen, with\ncards that display all of the available programs for that channel.\n\nYour app should have at least one channel. The first channel your\napp creates becomes its [default channel](/training/tv/discovery/recommendations-channel#default-channel),\nand Android TV displays that channel automatically on the home screen. Your app\ncan offer other channels, but the user must select and approve those channels\nbefore they are added to the home screen.\n\nIf your app features TV shows, movies, or other video content, we recommend that\nyou support [video previews](/training/tv/discovery/preview-videos) and\nintegrate with the [Watch Next channel](/training/tv/discovery/recommendations-channel#watch-next).\nThe Watch Next channel is controlled by the Android system. Your app can add\nuser-related programs to this channel, such as programs that the user marked as\ninteresting, stopped watching in the middle, or that are related to the content\nthe user is watching (like the next episode in a series or next season of a\nshow).\n\nEnsure compatibility\n--------------------\n\nThe home screen displays recommendations two different ways depending on the\nversion of Android:\n\n- In Android 8.0 (API level 26) and later, apps can show recommendations in one or more channels that appear on separate rows. One channel (the default channel) always appears. The user can discover and add the other channels to their home screen. Learn how to create [recommendation channels](/training/tv/discovery/recommendations-channel) on the home screen.\n- Before Android 8.0, Android TV shows all recommendations in a single recommendations row that always appears on the screen. Learn how to create the [recommendation row](/training/tv/discovery/recommendations-row) on the home screen.\n\nTo be able to show recommendations on all versions of Android TV, your app\nshould implement both recommendation APIs. Test the current system API level and\nuse the appropriate API to build the recommendation row or channels. \n\n### Kotlin\n\n```kotlin\nif (android.os.Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.O) {\n // Use the home screen recommendation channels API\n} else {\n // Use the recommendations row API\n}\n```\n\n### Java\n\n```java\nif (android.os.Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.O) {\n // Use the home screen recommendation channels API\n} else {\n // Use the recommendations row API\n}\n```\n\nIf your app was compiled using API level 25 or earlier, it can still run on\nAndroid TV in level 26. The old recommendations behavior is forward-compatible,\nbut constrained:\n\n- The recommendations row is automatically converted and appears as a new channel on the home screen.\n- The programs on the converted channel respond to updates from your [recommendation service](/training/tv/discovery/recommendations-row#service), but the user cannot use the TV's UI to manipulate the programs on the channel (add/remove programs, copy programs to the Watch Next channel).\n- If you update the app to API level 26, the converted channel still appears on TVs running API 26. The TV removes the converted channel from the screen the first time your app displays a channel created with the new API. This happens immediately if the app creates a [default channel](/training/tv/discovery/recommendations-channel#the_default_channel), or later when the user selects and adds any other channel created by your app.\n\n| **Note:** This forward-compatible behavior is temporary, it will be removed sometime in the future. To ensure compatibility, the best practice is to implement both APIs, as described above."]]