Kualitas aplikasi TV

Pengguna memiliki ekspektasi yang berbeda saat menonton TV dibandingkan saat menggunakan ponsel atau tablet. Seorang pengguna TV biasa duduk sekitar 3 meter dari layar, sehingga detail kecil kurang terlihat dan teks yang kecil sulit dibaca. Karena pengguna duduk jauh dari TV, mereka harus menggunakan perangkat remote control untuk membuka dan menentukan pilihan, bukan menyentuh elemen di layar. Perbedaan ini secara signifikan memengaruhi persyaratan dalam menciptakan pengalaman yang baik bagi pengguna TV.

Langkah pertama menuju terciptanya pengalaman luar biasa bagi pengguna TV adalah meninjau dan mengikuti panduan desain Android TV. Untuk memahami persyaratan implementasi dasar untuk aplikasi TV, tinjau juga pelatihan Membuat Aplikasi TV.

Untuk informasi tentang cara memublikasikan aplikasi TV Anda di Google Play, lihat Mendistribusikan ke Android TV.

Desain visual dan interaksi pengguna

Kriteria berikut membantu memastikan bahwa aplikasi Anda mengikuti pola desain dan interaksi penting untuk pengalaman pengguna yang konsisten, intuitif, dan menyenangkan di perangkat TV.

Jenis Pengujian Deskripsi
Peluncur TV-LM

Aplikasi menampilkan ikon peluncur di Peluncur Android TV setelah penginstalan. Untuk informasi selengkapnya, lihat Mendeklarasikan aktivitas TV.

TV-LB

Aplikasi menampilkan banner ukuran penuh 320x180 piksel dan setidaknya ikon aplikasi 160x160 piksel (pada kepadatan xhdpi) sebagai ikon peluncurnya di Peluncur Android TV. Untuk informasi selengkapnya, lihat Panduan banner dan ikon aplikasi Android TV.

TV-BN

Banner peluncur aplikasi berisi nama aplikasi.

TV-LG

Jika berupa game, aplikasi akan muncul di baris Game di Peluncur Android TV.
Untuk mengetahui informasi selengkapnya, lihat Menampilkan game di layar utama.

TV-LS

Aplikasi berhasil berjalan dan tanpa pesan error, termasuk selama penginstalan, pemuatan, dan pengujian. Untuk informasi selengkapnya, lihat Menjalankan aplikasi TV.

Tata Letak TV-LO

Semua antarmuka aplikasi ditampilkan dalam orientasi lanskap dan tanpa tampilan lebar/tampilan pilar vertikal. Hanya warna hitam yang dapat digunakan untuk area luar video pada video format asli. Untuk informasi selengkapnya, lihat Mem-build tata letak TV dasar.

TV-OV

Aplikasi tidak menampilkan teks atau fungsionalitas apa pun yang sebagian terpotong oleh tepi layar. Untuk informasi selengkapnya, lihat Overscan.

TV-TR

Aplikasi tidak menyembunyikan sebagian aplikasi lainnya. Aplikasi mengisi seluruh layar dan memiliki latar belakang non-transparan.

TV-DP

Fungsionalitas aplikasi dapat dilihat menggunakan kontrol D-pad lima arah—kecuali jika aplikasi memerlukan pengontrol game, sebagaimana ditetapkan dalam kriteria TV-GP di bagian Pengontrol pada tabel Fungsi yang akan menyusul. Untuk mengetahui informasi selengkapnya, lihat Navigasi TV.

TV-DK

Jika aplikasi memerlukan pengontrol game, sebagaimana ditetapkan dalam kriteria TV-GP, semua fungsi dapat dinavigasi menggunakan tombol pengontrol game standar Android. Untuk mengetahui informasi selengkapnya, lihat Memproses penekanan tombol gamepad.

TV-DM

Aplikasi tidak bergantung pada perangkat remote control yang memiliki tombol Menu untuk mengakses kontrol antarmuka pengguna.

TV-DB

Menekan tombol kembali akan mengarahkan kembali ke layar utama Android TV. Untuk mengetahui informasi selengkapnya, lihat Memberikan perilaku tombol Kembali yang sesuai.

TV-DL

Jika aplikasi memiliki feed TV live yang terintegrasi di tab Live, aplikasi memenuhi persyaratan pemutaran tanpa gangguan dan pemutaran langsung. Untuk informasi selengkapnya, lihat Tombol Kembali.

TV-SB

Kueri penelusuran dalam aplikasi muncul di kotak penelusuran, mirip dengan antarmuka pengguna yang disediakan oleh SearchFragment, dan hasilnya relevan dengan kueri tersebut. Untuk informasi selengkapnya, lihat Menelusuri dalam aplikasi TV.

Fungsi dan performa

Kriteria ini memastikan bahwa aplikasi Anda dikonfigurasi dengan benar dan memberikan perilaku fungsional yang diharapkan.

Jenis Pengujian Deskripsi
Manifes TV-ML

Manifes aplikasi menyetel jenis intent ACTION_MAIN dengan kategori CATEGORY_LEANBACK_LAUNCHER. Untuk informasi selengkapnya, lihat Mendeklarasikan aktivitas TV.

TV-MT

Manifes aplikasi menyetel agar android.hardware.touchscreen fitur hardware dan lainnya yang tercantum di "Mendeklarasikan persyaratan hardware untuk TV" tidak diperlukan. Untuk informasi selengkapnya, lihat Mendeklarasikan persyaratan hardware untuk TV.

Pengontrol Game TV-GP

Jika menggunakan pengontrol game sebagai metode input utamanya, aplikasi ini akan mendeklarasikan persyaratan yang tepat dengan tag manifes <uses-feature>. Untuk informasi selengkapnya, lihat Mendeklarasikan dukungan untuk pengontrol game.

TV-GC

Jika aplikasi menyediakan petunjuk visual untuk menggunakan pengontrol game, petunjuk tersebut bebas dari branding dan menampilkan tata letak tombol yang kompatibel. Untuk informasi selengkapnya, lihat Menangani pengontrol untuk game.

Iklan TV-AP

Aplikasi menawarkan interaksi dengan iklan menggunakan kontrol D-pad. Untuk informasi selengkapnya, lihat Mengaktifkan navigasi D-pad.

TV-AD

Untuk iklan yang menggunakan iklan non-video layar penuh, aplikasi memungkinkan pengguna segera menutup iklan dengan kontrol D-pad atau gamepad.

TV-AU

Untuk iklan yang menggunakan iklan non-video bukan layar penuh yang dapat diklik, aplikasi tidak mengizinkan iklan ditautkan ke URL web.

TV-AA

Untuk iklan yang menggunakan iklan non-video bukan layar penuh yang dapat diklik, aplikasi tidak mengizinkan iklan ditautkan ke aplikasi lain yang tidak tersedia di perangkat TV.

Konten Web TV-WB

Untuk konten web, aplikasi hanya boleh menggunakan komponen WebView. Aplikasi mungkin tidak mencoba meluncurkan aplikasi browser web.

Pemutaran Media TV-NP

Jika aplikasi terus memutar audio setelah pengguna kembali ke layar utama atau beralih ke aplikasi lain, aplikasi ini menyediakan kartu Now Playing pada baris rekomendasi layar utama sehingga pengguna dapat kembali ke aplikasi untuk mengontrol pemutaran. Untuk informasi selengkapnya, lihat Menampilkan kartu Now Playing.

Sebaiknya Anda menjeda video saat pengguna beralih keluar dari aplikasi, dan jangan mengintegrasikan video dengan kartu Sedang Diputar.

TV-PA

Jika aplikasi menyediakan kartu Now Playing, memilih kartu ini akan mengalihkan pengguna ke layar yang memungkinkan mereka menjeda pemutaran.

TV-PP

Jika aplikasi memutar konten video atau musik, aplikasi akan beralih antara memutar dan menjeda pemutaran media jika peristiwa tombol putar atau jeda dikirimkan selama pemutaran. Untuk informasi selengkapnya, lihat KEYCODE_MEDIA_PLAY_PAUSE.

TV-PC

Saat video atau audio diputar, menekan tombol tengah D-pad akan menjeda media yang sedang diputar. Saat pemutaran dijeda, menekan tombol tengah D-pad akan melanjutkan pemutaran. Tombol kiri dan kanan D-pad akan memutar maju cepat dan mundur cepat lagu saat ini. Untuk mengetahui informasi selengkapnya, lihat Peristiwa media.

TV-PN

Item ditambahkan ke saluran Tonton Berikutnya berdasarkan panduan Tonton Berikutnya untuk developer aplikasi.

Mode Standby TV-BU

Saat ada pemutaran video aktif yang dimulai pengguna, aplikasi akan mencegah perangkat masuk ke Mode Standby. Untuk mengetahui informasi selengkapnya, lihat Mode Standby.

TV-BY

Saat tidak ada pemutaran atau animasi video aktif yang dimulai pengguna, aplikasi tidak mencegah perangkat masuk ke Mode Standby.

TV-BA

Untuk pemutaran audio saja, aplikasi tidak mencegah perangkat masuk ke Mode Standby kecuali jika aplikasi menerapkan pengalaman gambar non-statis, seperti video musik atau gambar, saat musik diputar.

Memori
TV-ME

Untuk perangkat dengan RAM rendah (jika ActivityManager.isLowRamDevice() menampilkan nilai benar), penggunaan memori maksimum ( Anon+Swap + Graphics + File Memory) dari aplikasi latar depan harus tetap dalam batas (termasuk mekanisme pengukuran dan peringatan tertentu) yang ditentukan dalam Mengoptimalkan penggunaan memori.

Google Play

Ikuti persyaratan berikut untuk mengonfigurasi aplikasi Anda secara konsisten dengan listingan dan klasifikasi lain di Google Play:

Jenis Pengujian Deskripsi
Picture-in-picture TV-IC

Aplikasi menetapkan metadata yang tepat untuk mengategorikan penggunaan picture-in-picture ke salah satu jenis penggunaan yang diizinkan. Class ini juga mendeklarasikan judul dan subtitel yang secara akurat mewakili tujuan penggunaan PIP ini.

Untuk mengetahui informasi selengkapnya, lihat Multitasking di TV.

TV-IP

Saat dalam mode gambar dalam gambar, aplikasi tidak menampilkan materi promosi atau iklan yang pada dasarnya bukan bagian dari sumber konten.

TV-IQ

Saat dalam mode picture-in-picture, aplikasi tidak menurunkan pengalaman aktivitas layar penuh lainnya.

Aplikasi tidak boleh menggunakan resource yang berlebihan, mengambil alih fokus audio, mengganggu MediaSession aktif, atau meminta sesi dekoder dalam jumlah yang tidak proporsional.

TV-IH

Aplikasi tidak menampilkan kontrol UI atau elemen yang dapat dinavigasi saat dalam mode picture-in-picture. Aplikasi dapat mengekspos kontrol pengguna tertentu secara langsung di jendela PiP.

TV-IE

Memasukkan mode picture-in-picture memerlukan tindakan eksplisit dan disengaja oleh pengguna dalam aplikasi. Aplikasi tidak otomatis memasuki PiP (setAutoEnterEnabled disetel ke false) kecuali jika pengguna sedang dalam panggilan yang sedang berlangsung.

TV-IS

Aplikasi tidak boleh menampilkan UI apa pun untuk masuk ke PiP jika mode picture-in-picture dinonaktifkan di perangkat.

TV-IX

Aplikasi menggunakan mode picture-in-picture hanya untuk kelanjutan aktivitas yang sedang berlangsung. Pengalaman picture-in-picture tidak memberikan insentif atau mendorong pengguna untuk kembali ke tampilan layar penuh aplikasi selama aktivitas berlangsung atau setelah aktivitas selesai.

Kebijakan Play TV-G1

Penggunaan Android App Bundle diwajibkan untuk semua aplikasi TV baru dan yang sudah ada di Google Play Store.

TV-G2

Aplikasi Anda harus mematuhi persyaratan Pusat Kebijakan Developer Play.

Halaman detail aplikasi TV-G3

Fungsi aplikasi berfungsi seperti yang diharapkan atau seperti yang dijelaskan dalam listingan Google Play Store aplikasi.

TV-G4

Kiriman aplikasi telah mengupload minimal satu screenshot beresolusi tinggi yang tidak diubah dan secara akurat menggambarkan versi saat ini dari pengalaman aplikasi TV Anda.

Kredensial Login TV-G5

Untuk aplikasi dengan fitur berbayar, Anda harus memberikan kredensial login di Konsol Google Play untuk pengujian pengalaman aplikasi lengkap. Untuk mengetahui informasi selengkapnya, lihat Akses Aplikasi di Menyiapkan aplikasi untuk ditinjau.

Pertanyaan umum (FAQ)

Setelah mengirimkan aplikasi saya, bagaimana cara mengetahui apakah aplikasi saya tidak memenuhi semua persyaratan perangkat TV?

Jika aplikasi Anda tidak memenuhi persyaratan kegunaan yang telah dijelaskan pada halaman ini, tim Play Store akan menghubungi Anda melalui alamat email di akun Konsol Google Play yang terkait dengan aplikasi tersebut.

Perhatian: Pastikan aplikasi Anda menyertakan entri manifes yang diperlukan untuk perangkat TV. Jika tidak, aplikasi Anda tidak akan dianggap sebagai aplikasi TV dan tidak akan ditinjau untuk persyaratan kegunaan TV.

Aplikasi saya menargetkan faktor bentuk selain perangkat TV. Jika aplikasi saya tidak memenuhi persyaratan perangkat TV, apakah aplikasi saya yang baru atau yang telah diupdate akan tetap muncul di Google Play untuk perangkat lain?

Update pada listingan Google Play Store Anda hanya dapat dipublikasikan jika semua perubahan disetujui. Jika update artefak khusus faktor bentuk memblokir update lebih lanjut pada listingan Anda untuk perangkat lain seperti ponsel atau tablet, sebaiknya hapus artefak tersebut dengan menggantinya dengan kiriman kosong hingga Anda dapat memenuhi persyaratan.

Jika memenuhi persyaratan publikasi, kapan aplikasi saya akan tersedia di Google Play Store di perangkat TV?

Aplikasi yang memenuhi persyaratan TV akan segera muncul di Play Store di perangkat TV.