Đề xuất nội dung trên màn hình chính

Màn hình chính của Android TV hiển thị nội dung đề xuất bằng các kênhchươ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.