Chất lượng của ứng dụng dành cho TV

Sau khi cài đặt, ứng dụng sẽ cho thấy biểu tượng trình chạy trong Trình chạy Android TV. Để biết thêm thông tin, hãy xem phần Khai báo hoạt động trên TV.

Ứng dụng hiển thị cả biểu ngữ có kích thước đầy đủ 320x180 pixel và biểu tượng ứng dụng có kích thước tối thiểu 160x160 pixel (ở mật độ xhdpi) làm biểu tượng trình chạy trong Trình chạy Android TV. Để biết thêm thông tin, hãy xem Nguyên tắc về biểu ngữ và biểu tượng ứng dụng Android TV.

Trong biểu ngữ khởi chạy ứng dụng có tên của ứng dụng.

Nếu là trò chơi, ứng dụng sẽ xuất hiện ở hàng Trò chơi trong Trình chạy Android TV.
Để biết thêm thông tin, hãy xem phần Hiện trò chơi trên màn hình chính.

Ứng dụng chạy thành công và không có thông báo lỗi, bao gồm cả trong quá trình cài đặt, tải và kiểm thử. Để biết thêm thông tin, hãy xem phần Chạy ứng dụng TV.

Tất cả giao diện ứng dụng đều được thể hiện theo hướng ngang và không có khung hòm thư/khung trụ dọc. Bạn chỉ có thể sử dụng màu đen cho các thanh trên video ở định dạng gốc. Để biết thêm thông tin, hãy xem phần Tạo bố cục cơ bản cho TV.

Ứng dụng không cho thấy có văn bản hoặc chức năng nào bị một phần cạnh của màn hình cắt bớt. Để biết thêm thông tin, hãy xem phần Thừa phạm vi quét.

Ứng dụng không che khuất một phần các ứng dụng khác. Ứng dụng sẽ lấp đầy toàn bộ màn hình và có nền không trong suốt.

Bạn có thể di chuyển trong chức năng của ứng dụng bằng cách dùng các nút điều khiển D-pad 5 chiều, trừ phi ứng dụng đòi hỏi tay điều khiển trò chơi như nêu trong tiêu chí TV-GP trong phần Tay điều khiển của bảng Chức năng sau đây. Để biết thêm thông tin, hãy xem bài viết Điều hướng trên TV.

Nếu ứng dụng đòi hỏi tay điều khiển trò chơi như nêu trong tiêu chí TV-GP, thì bạn có thể thao tác mọi chức năng của ứng dụng bằng các phím trên tay điều khiển trò chơi Android tiêu chuẩn. Để biết thêm thông tin, hãy xem bài viết Xử lý thao tác nhấn nút trên tay điều khiển trò chơi.

Ứng dụng không phụ thuộc vào thiết bị điều khiển từ xa có nút Trình đơn để truy cập vào các chế độ điều khiển trên giao diện người dùng.

Thao tác nhấn nút quay lại sẽ đưa người dùng quay lại màn hình chính của Android TV. Để biết thêm thông tin, hãy xem phần Cung cấp hành vi thích hợp cho nút Quay lại.

Nếu ứng dụng có nguồn cấp dữ liệu truyền hình trực tiếp được tích hợp trên thẻ Trực tiếp, thì ứng dụng đó phải đáp ứng các yêu cầu về việc phát và phát lại nội dung trực tiếp sao cho mượt mà. Để biết thêm thông tin, hãy xem phần Nút quay lại.

Cụm từ tìm kiếm trong ứng dụng sẽ xuất hiện trong hộp tìm kiếm, cũng như trong giao diện người dùng do SearchFragment cung cấp. Đồng thời, các kết quả phải liên quan đến cụm từ tìm kiếm đó. Để biết thêm thông tin, hãy xem phần Tìm kiếm trong các ứng dụng TV.

Tệp kê khai ứng dụng sẽ thiết lập loại ý định ACTION_MAIN với danh mục CATEGORY_LEANBACK_LAUNCHER. Để biết thêm thông tin, hãy xem phần Khai báo hoạt động trên TV.

Tệp kê khai ứng dụng sẽ thiết lập tính năng phần cứng android.hardware.touchscreen và các tính năng khác được liệt kê trong phần "Khai báo yêu cầu về phần cứng cho TV" thành không bắt buộc. Để biết thêm thông tin, hãy xem phần Khai báo các yêu cầu về phần cứng cho TV.

Nếu sử dụng tay điều khiển trò chơi làm phương thức nhập chính, thì ứng dụng sẽ khai báo yêu cầu thích hợp bằng thẻ <uses-feature> của tệp kê khai. Để biết thêm thông tin, hãy xem phần Khai báo hỗ trợ tay điều khiển trò chơi.

Nếu ứng dụng cung cấp hướng dẫn bằng hình ảnh để sử dụng tay điều khiển trò chơi, thì hướng dẫn đó phải cho thấy bố cục nút tương thích và không được chứa nội dung thương hiệu. Để biết thêm thông tin, hãy xem phần Xử lý tay điều khiển cho trò chơi.

Ứng dụng cho phép tương tác với quảng cáo bằng bộ điều khiển D-pad. Để biết thêm thông tin, hãy xem phần Bật tính năng điều hướng bằng D-pad.

Đối với quảng cáo sử dụng toàn màn hình và không ở dạng video, thì ứng dụng sẽ cho phép người dùng loại bỏ quảng cáo ngay lập tức bằng bộ điều khiển D-pad hoặc tay điều khiển trò chơi.

Đối với quảng cáo có thể nhấp, không chiếm toàn màn hình và không ở dạng video, thì ứng dụng sẽ không cho phép quảng cáo đó liên kết đến một URL web.

Đối với quảng cáo có thể nhấp, không chiếm toàn màn hình và không ở dạng video, thì ứng dụng sẽ không cho phép quảng cáo đó liên kết đến một ứng dụng khác không có trên thiết bị TV.

Đối với nội dung web, ứng dụng chỉ có thể sử dụng các thành phần WebView. Ứng dụng không được tìm cách chạy ứng dụng trình duyệt web.

Nếu ứng dụng tiếp tục phát âm thanh sau khi người dùng quay lại màn hình chính hoặc chuyển sang một ứng dụng khác, thì ứng dụng đó sẽ cung cấp thẻ Phát hiện nhạc (Now Playing) trên hàng đề xuất trên màn hình chính để người dùng có thể quay lại ứng dụng để điều khiển chế độ phát. Để biết thêm thông tin, hãy xem phần Hiện thẻ Phát hiện nhạc.

Bạn nên tạm dừng video khi người dùng chuyển ra khỏi ứng dụng và không tích hợp video với thẻ Đang phát.

Nếu ứng dụng cung cấp thẻ Phát hiện nhạc (Now Playing), thì khi chọn thẻ này, người dùng sẽ được chuyển đến một màn hình cho phép họ tạm dừng phát.

Nếu ứng dụng phát nội dung video hoặc nhạc, thì ứng dụng đó sẽ chuyển đổi giữa chế độ phát và tạm dừng phát nội dung đa phương tiện khi có sự kiện nhấn phím phát hoặc tạm dừng được gửi trong quá trình phát. Để biết thêm thông tin, hãy xem KEYCODE_MEDIA_PLAY_PAUSE.

Khi đang phát video hoặc âm thanh, thao tác nhấn nút giữa D-pad sẽ tạm dừng việc phát nội dung đa phương tiện. Khi đang tạm dừng, thao tác nhấn nút giữa của D-pad sẽ tiếp tục quá trình phát. Các nút trái và phải của D-pad sẽ tua đi và tua lại theo bản nhạc hiện tại. Để biết thêm thông tin, hãy xem phần Sự kiện đa phương tiện.

Các mục được thêm vào kênh Watch Next dựa trên nguyên tắc của Watch Next dành cho nhà phát triển ứng dụng.

Khi có quá trình phát video đang hoạt động do người dùng khởi động, ứng dụng sẽ ngăn thiết bị chuyển sang Chế độ môi trường xung quanh. Để biết thêm thông tin, hãy xem phần Chế độ môi trường xung quanh.

Khi không có quá trình phát hoạt ảnh hoặc video đang hoạt động do người dùng khởi động, ứng dụng sẽ không ngăn thiết bị chuyển sang Chế độ môi trường xung quanh.

Để chỉ phát âm thanh, ứng dụng không được ngăn thiết bị chuyển sang Chế độ môi trường xung quanh, trừ phi ứng dụng triển khai trải nghiệm hình ảnh không tĩnh (chẳng hạn như video nhạc hoặc hình ảnh) trong khi phát nhạc.

Đối với các thiết bị có dung lượng RAM thấp (trong đó ActivityManager.isLowRamDevice() trả về giá trị true), mức sử dụng bộ nhớ tối đa (Anon+Swap + Graphics + File Memory) của một ứng dụng trên nền trước phải nằm trong giới hạn (bao gồm cả các cơ chế đo lường và lưu ý cụ thể) được xác định trong phần Tối ưu hoá mức sử dụng bộ nhớ.

Ứng dụng thiết lập siêu dữ liệu thích hợp để phân loại việc sử dụng chế độ hình trong hình thành một trong các loại hình sử dụng được phép. Tệp này cũng khai báo tiêu đề và phụ đề thể hiện chính xác mục đích sử dụng của PIP này.

Để biết thêm thông tin, hãy xem phần Làm nhiều việc cùng lúc trên TV.

Khi ở chế độ hình trong hình, ứng dụng không hiển thị tài liệu quảng bá hoặc quảng cáo không phải là một phần của nguồn nội dung.

Khi ở chế độ hình trong hình, ứng dụng không làm giảm trải nghiệm của một hoạt động toàn màn hình khác.

Ứng dụng không được sử dụng quá nhiều tài nguyên, chiếm quyền phát âm thanh, can thiệp vào MediaSession đang hoạt động hoặc yêu cầu số lượng phiên giải mã không tương xứng.

Ứng dụng không hiển thị bất kỳ thành phần điều khiển giao diện người dùng hoặc thành phần có thể điều hướng nào khi ở chế độ hình trong hình. Các ứng dụng có thể hiển thị một số chế độ điều khiển của người dùng nhất định ngay trong cửa sổ PiP.

Để chuyển sang chế độ hình trong hình, người dùng phải thực hiện hành động rõ ràng và có chủ ý trong ứng dụng. Ứng dụng sẽ không tự động chuyển sang chế độ PiP (setAutoEnterEnabled được đặt thành false) trừ phi người dùng đang thực hiện cuộc gọi.

Ứng dụng không được hiển thị giao diện người dùng nào để chuyển sang chế độ PiP nếu chế độ hình trong hình bị tắt trên thiết bị.

Ứng dụng chỉ sử dụng chế độ hình trong hình để tiếp tục một hoạt động đang diễn ra. Trải nghiệm hình trong hình không khuyến khích người dùng quay lại chế độ xem toàn màn hình của ứng dụng trong khi đang diễn ra hoặc sau khi hoạt động kết thúc.

Tất cả ứng dụng truyền hình mới và hiện có trong Cửa hàng Google Play đều bắt buộc phải sử dụng Android App Bundle.

Ứng dụng của bạn phải tuân thủ các yêu cầu của Trung tâm chính sách dành cho nhà phát triển của Play.

Chức năng của ứng dụng hoạt động đúng như mong đợi hoặc đúng như mô tả tại trang thông tin của ứng dụng trên Cửa hàng Google Play.

Ứng dụng đã tải lên ít nhất một ảnh chụp màn hình có độ phân giải cao và chưa qua chỉnh sửa, mô tả chính xác phiên bản hiện tại của trải nghiệm ứng dụng TV.

Đối với ứng dụng có tính năng trả phí, bạn phải cung cấp thông tin đăng nhập trong Google Play Console để kiểm thử toàn bộ trải nghiệm ứng dụng. Để biết thêm thông tin, hãy xem phần Quyền truy cập vào ứng dụng trong phần Chuẩn bị ứng dụng để xem xét.