Bersamaan dengan rilis Android 5.0, hadir Android TV, yang mendukung Google Cast. Dokumen ini menjelaskan 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 dapat berjalan di perangkat Chromecast terlebih dahulu sebelum dikembangkan dan diuji dengan Android TV.
Menyiapkan pengembangan
- Siapkan perangkat Android TV Anda:
- 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.
- Di baris Preferences, pilih Developer options, pilih USB debugging, lalu pilih On.
- Kembali ke layar utama. Anda harus melakukan hal ini untuk menerapkan setelan yang baru saja dipilih. Setelan akan tetap ada kecuali jika Anda mereset perangkat ke setelan pabrik.
- Daftarkan perangkat Android TV Anda di Konsol Developer Google Cast SDK, seperti yang dijelaskan dalam Pendaftaran Perangkat.
Proses debug
Untuk menguji dan men-debug aplikasi Penerima Web di perangkat Android TV, lakukan langkah berikut:
- Daftarkan perangkat Android TV dan aplikasi Anda di Google Cast SDK Developer Console. Lihat Pendaftaran untuk mengetahui informasi selengkapnya tentang cara mendaftarkan perangkat dan aplikasi.
- Mulai aplikasi pengirim dan transmisikan ke perangkat Android TV.
- Hubungkan ke perangkat Android TV Anda 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 Web Receiver ke debugger.
Di konsol Chrome Remote Debugger, aktifkan logging debug dengan memasukkan kode berikut:
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
Lihat Proses Debug untuk mengetahui informasi selengkapnya.
Panduan untuk kompatibilitas Android TV
Membuat aplikasi Cast Anda kompatibel dengan Android TV hanya memerlukan upaya tambahan. Berikut 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 dapat mengalihkan ke situs khusus seluler karena mendeteksi label "Android". Jangan berasumsi bahwa "Android" dalam string agen pengguna selalu menunjukkan pengguna seluler.
- Media stack 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, yang dapat menyebabkan 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 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", maka mungkin situs tidak dimuat pada platform berbasis Android.
- Meskipun Chromecast menampilkan halaman Penerima Web pada bidang grafis 720p, platform Cast lainnya termasuk Android TV dapat menampilkan halaman ini hingga 1080p. Pastikan halaman Penerima Web diskalakan dengan baik pada resolusi yang berbeda.
Menggunakan Android Debug Bridge
Platform Android TV ditampilkan di banyak jenis perangkat elektronik konsumen: televisi, dekoder, konsol game, dan sebagainya. Masing-masing konfigurasi dapat dikonfigurasi secara berbeda. Jika mengalami kesulitan saat mengakses resource sistem Android TV melalui antarmuka pengguna perangkat, Anda dapat menggunakan Android Debug Bridge (ADB) guna mendapatkan nomor seri perangkat untuk pendaftaran, serta men-debug aplikasi. Lihat Android Debug Bridge untuk informasi selengkapnya.
Menggunakan ADB melalui Wi-Fi
Untuk menghubungkan ke perangkat melalui ADB dengan koneksi Wi-Fi:
- Di perangkat Android TV, opsi developer diaktifkan seperti yang dijelaskan dalam Menyiapkan pengembangan.
- Pastikan komputer Anda terhubung ke jaringan yang sama dengan perangkat Android TV.
Buka terminal, lalu masukkan hal 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 akan memproses koneksi port ADB secara otomatis dan dapat dihubungkan tanpa menginisialisasi port. Perangkat Android TV retail standar tidak otomatis memproses koneksi ADB; untuk perangkat ini, Anda harus terhubung ke ADB terlebih dahulu dengan kabel USB dan menginisialisasi port.
- Siapkan perangkat Android TV untuk pengembangan, seperti yang dijelaskan dalam Menyiapkan pengembangan.
- Di Android TV, pada 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 pada Menggunakan ADB dengan kabel USB.
- Pastikan komputer Anda terhubung ke jaringan yang sama dengan perangkat Android TV.
Pada komputer, di terminal, lakukan inisialisasi port untuk TCP/IP dengan memasukkan hal berikut:
adb tcpip 5555
Cabut kabel USB, lalu masukkan hal berikut di terminal:
adb connect Android TV device IP address:5555
Jika perangkat Anda adalah Android TV yang digunakan developer, lakukan hal berikut:
- Pastikan komputer Anda terhubung ke jaringan yang sama dengan perangkat Android TV.
Buka terminal, lalu masukkan hal 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 dibuat dan bahwa perangkat Android TV berkomunikasi di seluruh jaringan dengan perintah berikut:
adb logcat