Kênh danh sách video phát tiếp theo là hàng thứ hai xuất hiện trên màn hình chính, sau hàng ứng dụng. Hệ thống tạo ra và duy trì kênh này. Ứng dụng của bạn có thể thêm chương trình vào kênh danh sách video phát tiếp theo: chương trình mà người dùng đánh dấu là thú vị, dừng xem giữa chừng hoặc có liên quan đến nội dung người dùng đang xem (như tập tiếp theo trong chương trình truyền hình dài tập hoặc phần tiếp theo của chương trình).
Kênh danh sách video phát tiếp theo có một số quy tắc ràng buộc: ứng dụng của bạn không thể di chuyển, loại bỏ hoặc ẩn hàng của kênh danh sách video phát tiếp theo.
Các bước
Việc chèn chương trình vào danh sách video phát tiếp theo cũng tương tự như chèn chương trình vào kênh của riêng bạn. Hãy xem các mục sau để biết thông tin chi tiết dành riêng cho danh sách video phát tiếp theo.
Khi chèn nội dung vào danh sách video phát tiếp theo, bạn phải tuân thủ các nguyên tắc sau:
- Nguyên tắc dành cho nhà phát triển ứng dụng về tính năng Watch Next
- Nguyên tắc dành cho tính năng danh sách video phát tiếp theo đối với nhà cung cấp dịch vụ truyền hình
Chọn một loại chương trình
Có 4 loại danh sách video phát tiếp theo. Chọn loại phù hợp:
| Loại | Ghi chú |
|---|---|
WATCH_NEXT_TYPE_CONTINUE |
Người dùng đã dừng xem nội dung. |
WATCH_NEXT_TYPE_NEXT |
Chương trình tiếp theo trong một loạt chương trình mà người dùng đang xem đã có sẵn. Ví dụ: nếu người dùng đang xem tập 3 của một bộ phim, thì ứng dụng có thể đề xuất họ xem tập 4 tiếp theo. |
WATCH_NEXT_TYPE_NEW |
Hiện đã có nội dung mới liên quan rõ ràng đến nội dung mà người dùng đang xem. Ví dụ: người dùng đang xem tập 5 của một bộ phim và tập 6 đã có thể xem được. |
WATCH_NEXT_TYPE_WATCHLIST |
Do hệ thống hoặc ứng dụng chèn khi người dùng lưu một chương trình. |
Để biết thêm thông tin, hãy xem phần Thuộc tính của danh sách video phát tiếp theo.
Sử dụng trình tạo WatchNextProgram
Sử dụng WatchNextProgram.Builder. Để biết thêm thông tin, hãy xem phần Thuộc tính của danh sách video phát tiếp theo.
val builder = WatchNextProgram.Builder() builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE) .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE) .setLastEngagementTimeUtcMillis(time) .setTitle("Title") .setDescription("Program description") .setPosterArtUri(uri) .setIntentUri(uri) .setInternalProviderId(appProgramId) val watchNextProgramUri = context.contentResolver .insert( TvContractCompat.WatchNextPrograms.CONTENT_URI, builder.build().toContentValues() )
Sử dụng TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId) để tạo Uri mà bạn cần cập nhật danh sách video phát tiếp theo.
Khi người dùng thêm một chương trình vào kênh danh sách video phát tiếp theo, hệ thống sẽ sao chép chương trình đó vào hàng. Thao tác này sẽ gửi ý định TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT để thông báo cho ứng dụng rằng chương trình đã được thêm. Ý định này bao gồm hai phần bổ sung: mã chương trình đã được sao chép và mã chương trình được tạo cho chương trình trong kênh danh sách video phát tiếp theo.