Dengan rilis Android 5.0, hadir Android TV yang mendukung Google Cast. Dokumen ini menjelaskan hal-hal yang perlu Anda lakukan untuk menyiapkan dan menguji di Android TV saat mengembangkan aplikasi Cast. Aplikasi Cast yang ada berjalan di Android TV tanpa upaya tambahan. Jika Anda mengembangkan aplikasi Cast untuk pertama kalinya, tinjau dokumentasi Google Cast dan kembangkan aplikasi Cast agar berjalan di perangkat Chromecast terlebih dahulu sebelum mengembangkan dan menguji dengan Android TV.
Menyiapkan pengembangan
- Menyiapkan perangkat Android TV:
- Hubungkan perangkat Android TV ke jaringan lokal.
- Login ke Akun Google Anda.
- Dari Settings, di baris Device, pilih About.
- Scroll ke bawah dan klik Build beberapa kali hingga dialog muncul dengan pesan, "You are now a developer."
- Jika proses debug USB:
- Pasang kabel USB, tetapi jangan dulu menghubungkan ujung master kabel USB ke komputer Anda.
- Di baris Preferences, pilih Developer options, pilih USB debugging, lalu pilih On.
- Buka kembali layar utama. Anda harus melakukannya untuk menerapkan pengaturan yang baru saja dipilih. Setelan akan tetap tersimpan kecuali Anda mereset ke setelan pabrik.
- Daftarkan perangkat Android TV Anda di Konsol Developer SDK Google Cast, seperti yang dijelaskan di Pendaftaran Perangkat.
Proses debug
Untuk menguji dan men-debug aplikasi Penerima Web di perangkat Android TV, lakukan hal berikut:
- Daftarkan perangkat Android TV dan aplikasi Anda di Konsol Developer Google Cast SDK. Lihat Pendaftaran untuk mengetahui informasi lebih lanjut tentang cara mendaftarkan perangkat dan aplikasi.
- Mulai aplikasi pengirim dan lakukan transmisi ke perangkat Android TV.
- Hubungkan ke perangkat Android TV melalui ADB, seperti yang dijelaskan dalam Menggunakan Android Debug Bridge.
- Di mesin pengembangan, buka jendela browser Chrome, lalu buka chrome://inspect.
- Klik link inspect untuk menghadirkan Penerima Web ke debugger.
Di konsol Chrome Remote Debugger, aktifkan logging debug dengan memasukkan hal berikut:
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
Lihat Proses debug untuk informasi selengkapnya.
Panduan untuk kompatibilitas Android TV
Membuat aplikasi Cast Anda kompatibel dengan Android TV tidak memerlukan banyak pekerjaan tambahan. Berikut adalah beberapa rekomendasi dan kesalahan umum yang harus dihindari untuk memastikan aplikasi Anda kompatibel dengan Android TV:
- Perhatikan bahwa string agen pengguna berisi "Android" dan "CrKey"; beberapa situs mungkin mengalihkan ke situs khusus seluler karena mendeteksi label "Android". Jangan berasumsi bahwa "Android" dalam string agen pengguna selalu menunjukkan pengguna seluler.
- Stack media Android dapat menggunakan GZIP transparan untuk mengambil data. Pastikan
data media Anda dapat merespons
Accept-Encoding: gzip. - Peristiwa media HTML5 Android TV dapat dipicu dalam waktu yang berbeda dengan Chromecast, hal ini dapat mengungkapkan masalah yang disembunyikan di Chromecast.
- Saat memperbarui media, gunakan peristiwa terkait media yang diaktifkan oleh elemen
<audio>/<video>, sepertitimeupdate,pause, danwaiting. Hindari penggunaan peristiwa terkait jaringan sepertiprogress,suspend, danstalled, karena peristiwa ini cenderung bergantung pada platform. - Saat mengonfigurasi sertifikat HTTPS situs Penerima Web, pastikan untuk menyertakan sertifikat CA perantara. Lihat halaman pengujian SSL Qualsys untuk memverifikasi: jika jalur sertifikasi tepercaya untuk situs Anda menyertakan sertifikat CA berlabel “download tambahan”, jalur tersebut mungkin tidak akan dimuat di platform berbasis Android.
- Meskipun Chromecast menampilkan halaman Penerima Web pada bidang grafis 720p, platform Cast lainnya termasuk Android TV dapat menampilkan halaman hingga 1080p. Pastikan halaman Penerima Web Anda diskalakan dengan baik pada resolusi yang berbeda.
Menggunakan Android Debug Bridge
Platform Android TV ditampilkan di berbagai jenis perangkat elektronik konsumen: televisi, dekoder, konsol game, dan sebagainya. Setiap tombol dapat dikonfigurasi secara berbeda. Jika mengalami kesulitan mengakses resource sistem Android TV melalui antarmuka pengguna perangkat, Anda dapat menggunakan Android Debug Bridge (ADB) untuk mendapatkan nomor seri perangkat untuk pendaftaran, serta untuk men-debug aplikasi Anda. Lihat Android Debug Bridge untuk mengetahui informasi selengkapnya.
Menggunakan ADB melalui Wi-Fi
Untuk menghubungkan ke perangkat melalui ADB dengan koneksi Wi-Fi:
- Di perangkat Android TV, aktifkan opsi developer seperti yang dijelaskan dalam Menyiapkan pengembangan.
- Pastikan komputer Anda terhubung ke jaringan yang sama dengan perangkat Android TV.
Buka terminal dan masukkan perintah berikut:
adb connect Android TV device IP address:4321
Di komputer, buka terminal dan masukkan perintah ADB. Anda dapat memverifikasi bahwa koneksi telah dibuat dan bahwa perangkat Android TV berkomunikasi di seluruh jaringan dengan perintah berikut:
adb logcat
Menggunakan ADB dengan kabel USB
Untuk menghubungkan ke perangkat melalui ADB dengan koneksi kabel USB:
- Siapkan perangkat Android TV untuk pengembangan, seperti yang dijelaskan dalam Menyiapkan pengembangan.
- Hubungkan ujung master kabel USB ke komputer.
- Dalam dialog Allow USB debugging?, pilih Always allow from this computer, lalu pilih OK.
Di komputer, buka terminal dan masukkan perintah ADB. Anda dapat memverifikasi bahwa koneksi telah dibuat dan bahwa perangkat Android TV berkomunikasi di seluruh jaringan dengan perintah berikut:
adb logcat
Menggunakan ADB melalui TCP/IP
ADB berfungsi tanpa kabel USB, melalui TCP/IP, tetapi Anda harus mendapatkan alamat IP perangkat Android TV terlebih dahulu. Perangkat masalah developer memproses koneksi port ADB secara otomatis dan dapat terhubung tanpa melakukan inisialisasi port. Perangkat Android TV retail standar tidak memproses koneksi ADB secara otomatis; untuk perangkat ini, Anda harus terhubung ke ADB terlebih dahulu dengan kabel USB dan melakukan inisialisasi port.
- Siapkan perangkat Android TV untuk pengembangan, seperti yang dijelaskan dalam Menyiapkan pengembangan.
- Di Android TV, di baris Device, pilih Network > Wi-Fi, lalu pilih jaringan yang terhubung.
- Pilih Info status dan catat Alamat IP.
Jika perangkat Anda adalah perangkat Android TV retail standar, lakukan hal berikut:
- Ikuti langkah-langkah di bagian Menggunakan ADB dengan kabel USB.
- Pastikan komputer Anda terhubung ke jaringan yang sama dengan perangkat Android TV.
Di komputer, di terminal, inisialisasi port untuk TCP/IP dengan memasukkan perintah berikut:
adb tcpip 5555
Lepaskan kabel USB, dan masukkan berikut ini di terminal:
adb connect Android TV device IP address:5555
Jika perangkat Anda adalah Android TV masalah developer, lakukan hal berikut:
- Pastikan komputer Anda terhubung ke jaringan yang sama dengan perangkat Android TV.
Buka terminal dan masukkan perintah berikut:
adb connect Android TV device IP address:4321
Di Android TV, dalam dialog Allow USB debugging?, pilih Always allow from this computer, lalu pilih OK. Anda dapat memverifikasi bahwa koneksi telah tersambung dan bahwa perangkat Android TV berkomunikasi di seluruh jaringan dengan perintah berikut:
adb logcat