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. Guna memahami persyaratan implementasi dasar untuk aplikasi TV, tinjau juga pelatihan Membuat Aplikasi TV.

Untuk mengetahui informasi tentang cara memublikasikan aplikasi TV 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 mengetahui informasi selengkapnya, lihat Mendeklarasikan aktivitas TV.

TV-LB

Aplikasi menampilkan banner ukuran penuh 320x180 piksel dan setidaknya ikon aplikasi 160x160 piksel (dengan kepadatan xhdpi) sebagai ikon peluncurnya di Peluncur Android TV. Untuk mengetahui 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 informasi selengkapnya, lihat Menampilkan game di layar utama.

TV-LS

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

Tata Letak TV-LO

Semua antarmuka aplikasi ditampilkan dalam orientasi lanskap dan tanpa tampilan lebar/tampilan tinggi vertikal. Hanya warna hitam yang dapat digunakan untuk batang pada video format asli. Untuk mengetahui informasi selengkapnya, lihat Membuat tata letak TV dasar.

TV-OV

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

TV-TR

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

TV-DP

Fungsionalitas aplikasi dapat dijelajahi 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 ada di bawah. Untuk informasi selengkapnya, lihat Navigasi TV.

TV-DK

Jika aplikasi memerlukan pengontrol game, sebagaimana ditetapkan dalam kriteria TV-GP, semua fungsionalitas dapat dikendalikan 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 informasi selengkapnya, lihat Menyediakan 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 mengetahui informasi selengkapnya, lihat Tombol Kembali.

TV-SB

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

Fungsi

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 mengetahui informasi selengkapnya, lihat Mendeklarasikan aktivitas TV.

TV-MT

Manifes aplikasi menyetel agar fitur hardware android.hardware.touchscreen dan fitur lainnya yang tercantum dalam "Deklarasikan persyaratan hardware untuk TV" tidak diperlukan. Untuk mengetahui 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 mengetahui informasi selengkapnya, lihat Mendeklarasikan dukungan untuk pengontrol game.

TV-GC

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

Iklan TV-AP

Aplikasi menawarkan interaksi dengan iklan menggunakan kontrol D-pad. Untuk mengetahui 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 dapat menggunakan komponen WebView. Aplikasi tidak boleh 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 tersebut akan 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 keluar dari aplikasi dan tidak mengintegrasikan video dengan kartu Now Playing.

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 mengetahui 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 kanan dan kiri D-pad masing-masing memajukan dan memundurkan trek 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 mengimplementasikan pengalaman gambar non-statis, seperti video musik atau gambar, saat musik diputar.

Google Play

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

Jenis Pengujian Deskripsi
Picture-in-picture IC TV

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

Untuk mengetahui informasi selengkapnya, lihat Multitasking di TV.

IP TV

Saat menggunakan mode picture-in-picture, aplikasi tidak menampilkan materi promosi atau iklan yang bukan merupakan bagian inheren dari sumber konten.

TV-IQ

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

Aplikasi tidak boleh menggunakan resource berlebihan, mengambil alih fokus audio, mengganggu MediaSession yang aktif, atau meminta jumlah sesi decoder 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 masuk ke PiP (setAutoEnterEnabled disetel ke false) kecuali jika pengguna sedang dalam panggilan.

TV-IS

Aplikasi tidak boleh menampilkan UI 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 mendorong atau mendorong pengguna untuk kembali ke tampilan layar penuh aplikasi selama proses berlangsung atau setelah aktivitas selesai.

Kebijakan Play TV-G1

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

TV-G2

Aplikasi harus mengikuti persyaratan Pusat Kebijakan Developer Play.

Halaman detail aplikasi TV-G3

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

TV-G4

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

Kredensial Login TV-G5

Untuk aplikasi dengan fitur berbayar, Anda harus memberikan kredensial login di Konsol Google Play untuk menguji pengalaman aplikasi secara menyeluruh. 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 saja. 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 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 pengiriman kosong sampai persyaratannya terpenuhi.

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.