Halaman ini diterjemahkan oleh Cloud Translation API.

Android TV dengan Google Cast

Android TV yang mendukung Google Cast dirilis bersama dengan Android 5.0. Dokumen ini menjelaskan hal-hal yang perlu Anda lakukan untuk menyiapkan dan menguji di Android TV saat mengembangkan aplikasi Cast. Aplikasi Cast yang sudah ada berjalan di Android TV tanpa upaya tambahan. Jika Anda mengembangkan aplikasi Cast untuk pertama kalinya, tinjau dokumentasi Google Cast dan mengembangkan aplikasi Cast agar berjalan di perangkat Chromecast terlebih dahulu sebelum pengembangan dan pengujian dengan Android TV.

Menyiapkan untuk pengembangan

Menyiapkan perangkat Android TV:
1. Hubungkan perangkat Android TV ke jaringan lokal.
2. Login ke Akun Google Anda.
Dari Settings, di baris Device, pilih About.
Scroll ke bawah dan klik Build beberapa kali hingga muncul dialog muncul dengan pesan, "Sekarang Anda adalah pengembang".
Jika proses debug USB:
1. Pasang kabel USB, tetapi jangan hubungkan ujung master kabel USB ke komputer Anda.
2. Di baris Preferensi, pilih Opsi developer, lalu pilih Proses debug USB, lalu pilih Aktif.
Kembali ke layar utama. Anda harus melakukannya untuk menerapkan setelan yang baru saja dipilih. Setelan ini akan tetap ada kecuali Anda mereset ke setelan pabrik.
Daftarkan perangkat Android TV Anda di Konsol Developer SDK Google Cast, sebagai yang dijelaskan dalam Pendaftaran Perangkat.

Proses Debug

Untuk menguji dan men-debug aplikasi Web Receiver di perangkat Android TV, lakukan berikut ini:

Daftarkan perangkat Android TV dan aplikasi Anda di Konsol Developer SDK Google Cast. Lihat Pendaftaran untuk informasi selengkapnya tentang mendaftarkan perangkat dan aplikasi.
Mulai aplikasi pengirim dan transmisikan ke perangkat Android TV.
Menghubungkan ke perangkat Android TV melalui ADB, seperti yang dijelaskan dalam Menggunakan Android Debug Bridge.
Di mesin pengembangan, buka jendela browser Chrome dan buka chrome://inspect.
Catatan: Ini adalah berbeda dari opsi proses debug untuk perangkat Chromecast, yang mengarahkan Anda ke Alamat IP Penerima Web di port 9222.
Klik link inspect untuk memindahkan Penerima Web ke debugger.
Di konsol Debugger Jarak Jauh Chrome, aktifkan logging debug dengan memasukkan berikut ini:
```
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
```

Lihat Proses debug untuk mengetahui informasi selengkapnya.

Panduan untuk kompatibilitas Android TV

Membuat aplikasi Cast yang kompatibel dengan Android TV tidak memerlukan banyak pekerjaan tambahan. Berikut adalah beberapa rekomendasi dan kesalahan umum yang harus dihindari dalam untuk memastikan aplikasi Anda kompatibel dengan Android TV:

Perlu diketahui bahwa string agen pengguna berisi "Android" dan "CrKey"; beberapa situs mungkin mengalihkan ke situs khusus seluler karena mendeteksi "Android" label. Jangan berasumsi bahwa "Android" dalam string agen pengguna selalu menunjukkan pengguna seluler.
Tumpukan 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 pengaturan waktu yang berbeda Chromecast, informasi ini dapat mengungkapkan masalah yang disembunyikan di Chromecast.
Saat memperbarui media, gunakan peristiwa terkait media yang diaktifkan oleh <audio>/<video> elemen, seperti timeupdate, pause, dan waiting. Hindari penggunaan peristiwa terkait jaringan seperti progress, suspend, dan stalled, karena model ini cenderung bergantung pada platform.
Saat mengonfigurasi sertifikat HTTPS situs Penerima Web, pastikan untuk menyertakan sertifikat CA perantara. Lihat Halaman pengujian SSL Qualsys untuk verifikasi: apakah jalur sertifikasi tepercaya untuk situs Anda menyertakan CA sertifikat berlabel “download tambahan”, maka sertifikat tersebut mungkin tidak dimuat di perangkat berbasis Android di seluruh platform Google.
Meskipun Chromecast menampilkan laman Penerima Web pada bidang grafis 720p, platform Cast lainnya, termasuk Android TV, dapat menampilkan halaman hingga 1080p. Pastikan halaman Penerima Web dapat diskalakan dengan baik pada berbagai resolusi.

Menggunakan Android Debug Bridge

Platform Android TV ditampilkan di berbagai jenis perangkat elektronik konsumen perangkat: televisi, dekoder, konsol game, dan sebagainya. Masing-masing dapat dikonfigurasi secara berbeda. Jika Anda mengalami kesulitan mengakses resource sistem Android TV melalui antarmuka pengguna perangkat, Anda dapat menggunakan Android Debug Bridge (ADB) untuk mendapatkan nomor seri perangkat Anda untuk pendaftaran, serta untuk men-debug aplikasi Anda. Lihat Android Debug Bridge untuk lainnya tidak akurat atau tidak sesuai.

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 di Menyiapkan pengembangan.
Pastikan komputer Anda terhubung ke jaringan yang sama dengan Android perangkat TV.

Buka terminal dan masukkan kode berikut:

adb connect Android TV device IP address:4321

Di komputer, buka terminal dan masukkan perintah ADB. Anda dapat memverifikasi terhubung 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:

Menyiapkan perangkat Android TV untuk pengembangan, seperti yang dijelaskan di Menyiapkan pengembangan.
Hubungkan ujung utama kabel USB ke komputer.
Dalam dialog Allow USB debugging?, pilih Always allow from di komputer ini, lalu pilih OK.
Di komputer, buka terminal dan masukkan perintah ADB. Anda dapat memverifikasi terhubung 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 menginstal Android Alamat IP perangkat TV. Perangkat masalah developer memproses koneksi port ADB secara otomatis dan dapat terhubung tanpa menginisialisasi porta. Standar perangkat Android TV retail tidak memproses koneksi ADB secara otomatis; untuk perangkat ini, Anda harus terlebih dahulu terhubung ke ADB dengan kabel USB dan porta.

Menyiapkan perangkat Android TV untuk pengembangan, seperti yang dijelaskan di Menyiapkan pengembangan.
Di Android TV, di baris Perangkat, pilih Jaringan > Wi-Fi, dan pilih jaringan yang terhubung.
Pilih Info status dan catat Alamat IP.
Jika perangkat Anda adalah perangkat Android TV retail standar, lakukan hal berikut:
1. Ikuti langkah-langkah di bawah Menggunakan ADB dengan kabel USB.
2. Pastikan komputer Anda terhubung ke jaringan yang sama dengan Android perangkat TV.
3. Di komputer Anda, di terminal, lakukan inisialisasi porta untuk TCP/IP dengan dengan memasukkan berikut ini:
```
adb tcpip 5555
```
4. Lepaskan kabel USB, dan masukkan kode berikut ke terminal:
```
adb connect Android TV device IP address:5555
```
Jika perangkat Anda adalah Android TV masalah developer, lakukan hal berikut:
1. Pastikan komputer Anda terhubung ke jaringan yang sama dengan Android perangkat TV.
2. Buka terminal dan masukkan kode berikut:
```
adb connect Android TV device IP address:4321
```
Di Android TV, pada dialog Allow USB debugging?, pilih Selalu izinkan dari komputer ini, lalu pilih OK. Anda dapat memverifikasi koneksi dan bahwa perangkat Android TV berkomunikasi di seluruh dengan perintah berikut:
```
adb logcat
```