Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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:
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 muncul dialog
muncul dengan pesan, "Sekarang Anda adalah pengembang".
Jika proses debug USB:
Pasang kabel USB, tetapi jangan hubungkan ujung master kabel USB
ke komputer Anda.
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.
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.
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:
Pastikan komputer Anda terhubung ke jaringan yang sama dengan Android
perangkat TV.
Di komputer Anda, di terminal, lakukan inisialisasi porta untuk TCP/IP dengan
dengan memasukkan berikut ini:
adb tcpip 5555
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:
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 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:
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\u003cp\u003eExisting Google Cast applications are compatible with Android TV without requiring modifications.\u003c/p\u003e\n"],["\u003cp\u003eBefore developing for Android TV, create a Cast application for Chromecast as a prerequisite.\u003c/p\u003e\n"],["\u003cp\u003eTo debug a Web Receiver on Android TV, connect through ADB and use Chrome DevTools (chrome://inspect).\u003c/p\u003e\n"],["\u003cp\u003eEnsure your Web Receiver handles various resolutions and potential user-agent string issues for compatibility.\u003c/p\u003e\n"],["\u003cp\u003eAndroid TV supports ADB debugging via USB, Wi-Fi, or TCP/IP for easier development and troubleshooting.\u003c/p\u003e\n"]]],[],null,["# Android TV with Google Cast\n\nWith the release of Android 5.0 comes Android TV, which supports Google Cast.\nThis document describes what you need to do to set up and test on Android TV\nwhen developing Cast applications. Your existing Cast application runs on\nAndroid TV with no additional effort. If you are developing a Cast application\nfor the first time, review the [Google Cast documentation](/cast/docs/developers)\nand develop your Cast application to run on a Chromecast device first before\ndeveloping and testing with Android TV.\n| **Note:** This document assumes that you have already developed an application that runs on a Chromecast device, as that is a mandatory first step toward having your Cast application running on Android TV.\n\nSetting up for development\n--------------------------\n\n1. Set up your Android TV device:\n 1. Connect the Android TV device to the local network.\n 2. Sign into your Google account.\n2. From the **Settings** , in the **Device** row, select **About**.\n3. Scroll down to and click on **Build** several times until a dialog appears with the message, \"You are now a developer.\"\n4. If USB debugging:\n 1. Install the USB cable, but don't connect the master end of the USB cable to your computer just yet.\n 2. In the **Preferences** row, select **Developer options** , select **USB debugging** , and select **On**.\n5. Navigate back to the home screen. You must do this to apply the settings you just selected. The settings will persist unless you perform a factory reset.\n6. Register your Android TV device on the [Google Cast SDK Developer Console](https://cast.google.com/publish), as described in [Device Registration](/cast/docs/registration#RegisterDevice).\n\nDebugging\n---------\n\nTo test and debug your Web Receiver application on your Android TV device, do the\nfollowing:\n\n1. Register your Android TV device and your application on the [Google Cast SDK Developer Console](https://cast.google.com/publish). See [Registration](/cast/docs/registration) for more information about registering devices and applications.\n2. Start your sender application and cast to the Android TV device.\n3. Connect to your Android TV device via ADB, as described in [Using Android Debug Bridge](#using_android_debug_bridge).\n4. On your development machine, open a Chrome browser window and navigate to **chrome://inspect** . **Note:** This is different than the [debugging option for a Chromecast device](/cast/docs/debugging#chrome_remote_debugger), where you navigate to your Web Receiver's IP address on port 9222.\n5. Click the **inspect** link to bring the Web Receiver into the debugger.\n6. In the Chrome Remote Debugger console, enable debug logging by entering the\n following:\n\n cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);\n\nSee [Debugging](/cast/docs/debugging) for more information.\n\nGuidelines for Android TV compatibility\n---------------------------------------\n\nMaking your Cast application compatible with Android TV requires very little\nadditional work. Here are some recommendations and common pitfalls to avoid in\norder to ensure your application is compatible with Android TV:\n\n- Be aware that the user-agent string contains both \"Android\" and \"CrKey\"; some sites may redirect to a mobile-only site because they detect the \"Android\" label. Don't assume that \"Android\" in the user-agent string always indicates a mobile user.\n- Android's media stack may use transparent GZIP for fetching data. Make sure your media data can respond to `Accept-Encoding: gzip`.\n- Android TV HTML5 media events may be triggered in different timings than Chromecast, this may reveal issues that were hidden on Chromecast.\n- When updating the media, use media related events fired by `\u003caudio\u003e/\u003cvideo\u003e` elements, like `timeupdate`, `pause` and `waiting`. Avoid using networking related events like `progress`, `suspend` and `stalled`, as these tend to be platform dependent.\n- When configuring your Web Receiver site's HTTPS certificates, be sure to include intermediate CA certificates. See the [Qualsys SSL test page](https://www.ssllabs.com/ssltest/analyze.html) to verify: if the trusted certification path for your site includes a CA certificate labelled \"extra download\", then it may not load on Android-based platforms.\n- While Chromecast displays the Web Receiver page on a 720p graphics plane, other Cast platforms including Android TV may display the page up to 1080p. Ensure your Web Receiver page scales gracefully at different resolutions.\n\nUsing Android Debug Bridge\n--------------------------\n\nThe Android TV platform is featured on many kinds of consumer electronics\ndevices: televisions, set-top boxes, gaming consoles and so forth.\nEach may be configured differently. If you are having difficulty accessing the\nAndroid TV system resources through the device's user interface, you may\nuse the Android Debug Bridge (ADB) to obtain your device's serial number for\nregistration, as well as to debug your application. See [Android\nDebug Bridge](http://developer.android.com/tools/help/adb.html) for more\ninformation.\n\n### Using ADB over Wi-Fi\n\nTo connect to your device via ADB with a Wi-Fi connection:\n\n1. On your Android TV device, enabled developer options as described in [Setting up for development](#setting_up_for_development).\n2. Be sure your computer is connected to the same network as your Android TV device.\n3. Open a terminal and enter the following:\n\n ```\n adb connect Android TV device IP address:4321\n ```\n4. On your computer, open a terminal and enter ADB commands. You can verify the\n connection is established and that the Android TV device is communicating\n across the network with the following command:\n\n ```\n adb logcat\n ```\n\n### Using ADB with a USB cable\n\nTo connect to your device via ADB with a USB cable connection:\n\n1. Set up your Android TV device for development, as described in [Setting up for development](#setting_up_for_development).\n2. Connect the master end of the USB cable to your computer.\n3. In the **Allow USB debugging?** dialog, select **Always** allow from this computer, and select **OK**.\n4. On your computer, open a terminal and enter ADB commands. You can verify the\n connection is established and that the Android TV device is communicating\n across the network with the following command:\n\n ```\n adb logcat\n ```\n\n### Using ADB over TCP/IP\n\nADB works without a USB cable, over TCP/IP, but you must first get the Android\nTV device's IP address. Developer-issue devices listen for ADB port connections\nautomatically and can be connected without initializing the port. Standard\nretail Android TV devices do not listen for ADB connections automatically; for\nthese devices, you must first connect to ADB with a USB cable and initialize\nthe port.\n\n1. Set up your Android TV device for development, as described in [Setting up for development](#setting_up_for_development).\n2. On the Android TV, in the **Device** row, select **Network** \\\u003e **Wi-Fi**, and select the connected network.\n3. Select **Status info** and note the **IP address**.\n4. If your device is a standard, retail Android TV device, do the following:\n\n 1. Follow the steps under [Using ADB with a USB cable](#using_adb_with_a_usb_cable).\n 2. Be sure your computer is connected to the same network as the Android TV device.\n 3. On your computer, in a terminal, initialize the port for TCP/IP by\n entering the following:\n\n ```\n adb tcpip 5555\n ```\n 4. Remove the USB cable, and enter the following in the terminal:\n\n ```\n adb connect Android TV device IP address:5555\n ```\n5. If your device is a developer-issue Android TV, do the following:\n\n 1. Be sure your computer is connected to the same network as your Android TV device.\n 2. Open a terminal and enter the following:\n\n ```\n adb connect Android TV device IP address:4321\n ```\n6. On the Android TV, in the **Allow USB debugging?** dialog, select **Always\n allow from this computer** , and select **OK**. You can verify the connection\n is established and that the Android TV device is communicating across the\n network with the following command:\n\n ```\n adb logcat\n ```"]]
