Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Con el lanzamiento de Android 5.0, viene Android TV, que es compatible con Google Cast.
En este documento, se describe lo que debes hacer para configurar y realizar pruebas en Android TV
cuando desarrollas aplicaciones de Cast. Tu aplicación de Cast existente se ejecutará en
Android TV sin esfuerzo adicional. Si estás desarrollando una aplicación de Cast
por primera vez, revisa la documentación de Google Cast
y desarrollar tu aplicación de Cast para que se ejecute en un dispositivo Chromecast antes
desarrollar y realizar pruebas con Android TV.
Configuración para el desarrollo
Para configurar tu dispositivo Android TV, haz lo siguiente:
Conecta el dispositivo Android TV a la red local.
Accede a tu Cuenta de Google.
Desde la Configuración, en la fila Dispositivo, selecciona Acerca de.
Desplázate hacia abajo y haz clic en Build varias veces hasta que aparezca un diálogo.
aparecerá el mensaje "Ahora eres desarrollador".
Si se trata de una depuración por USB:
Instala el cable USB, pero no conectes el extremo principal del cable USB.
a tu computadora.
En la fila Preferencias, selecciona Opciones para desarrolladores.
Depuración por USB y selecciona Activada.
Regresa a la pantalla principal. Debes hacerlo para aplicar la configuración que
recién seleccionada. La configuración se mantendrá, a menos que restablezcas la configuración de fábrica.
Lineamientos para la compatibilidad con Android TV
Hacer que tu aplicación de Cast sea compatible con Android TV requiere muy poco
trabajo adicional. Estas son algunas recomendaciones y errores comunes que se deben evitar
para asegurarte de que tu aplicación sea compatible con Android TV:
Ten en cuenta que la cadena user-agent contiene "Android" y "CrKey";
algunos sitios pueden redireccionar a un sitio solo para dispositivos móviles porque detectan la
“Android” etiqueta. No asumas que "Android" En la cadena user-agent siempre
indica un usuario de dispositivo móvil.
La pila de contenido multimedia de Android puede usar una GZIP transparente para recuperar datos. Asegúrate de que
tus datos multimedia pueden responder a Accept-Encoding: gzip.
Los eventos multimedia HTML5 de Android TV pueden activarse en momentos diferentes del
Chromecast, esto puede revelar problemas ocultos en el Chromecast.
Cuando actualices el contenido multimedia, usa los eventos relacionados con el contenido multimedia que activa <audio>/<video>.
elementos, como timeupdate, pause y waiting.
Evita usar eventos relacionados con las herramientas de redes, como progress, suspend y
stalled, ya que tienden a depender de la plataforma.
Al configurar los certificados HTTPS del sitio del receptor web, asegúrate de
incluyen certificados de la AC intermedios. Consulta la
Página de prueba de SSL de Qualsys para
verificar si la ruta de certificación de confianza para tu sitio incluye una AC
certificado con la etiqueta "descarga adicional",
es posible que no se cargue con dispositivos Android
y plataformas de Google Cloud.
Mientras Chromecast muestra la página del receptor web en un plano gráfico de 720 p,
otras plataformas de transmisión, como Android TV, pueden mostrar la página en hasta 1080p.
Asegúrate de que la página del receptor web se ajuste correctamente en distintas resoluciones.
Cómo usar Android Debug Bridge
La plataforma de Android TV aparece en muchos tipos de dispositivos electrónicos de consumo.
televisores, decodificadores, consolas de juegos, etc.
Cada uno puede configurarse de forma diferente. Si tienes dificultades para acceder al
recursos del sistema de Android TV a través de la interfaz de usuario del dispositivo, puedes
usa Android Debug Bridge (ADB) para obtener el número de serie de tu dispositivo para
y depurar tu aplicación. Consulta Android
Debug Bridge para obtener más información
información.
Cómo usar adb con Wi-Fi
Para conectarte a tu dispositivo mediante adb con una conexión Wi-Fi, haz lo siguiente:
Asegúrate de que la computadora esté conectada a la misma red que tu dispositivo Android.
TV.
Abre una terminal e ingresa lo siguiente:
adb connect Android TV device IP address:4321
En la computadora, abre una terminal y, luego, ingresa los comandos de ADB. Puedes verificar el
y que el dispositivo Android TV se esté comunicando
en la red con el siguiente comando:
adb logcat
Cómo usar ADB con un cable USB
Para conectar tu dispositivo mediante ADB con un cable USB, haz lo siguiente:
Conecta el extremo principal del cable USB a la computadora.
En el cuadro de diálogo ¿Permitir depuración por USB?, selecciona Permitir siempre desde
esta computadora y selecciona Aceptar.
En la computadora, abre una terminal y, luego, ingresa los comandos de ADB. Puedes verificar el
y que el dispositivo Android TV se esté comunicando
en la red con el siguiente comando:
adb logcat
Cómo usar ADB mediante TCP/IP
ADB funciona sin cable USB a través de TCP/IP, pero primero debes obtener
Dirección IP del dispositivo de TV. Los dispositivos con problemas de los desarrolladores detectan conexiones de puertos de ADB
automáticamente y se pueden conectar sin inicializar el puerto. Estándar
Los dispositivos Android TV de venta minorista no detectan conexiones ADB automáticamente. para
estos dispositivos, primero debes conectarte a ADB con un cable USB y, luego, inicializar
el puerto.
Asegúrate de que tu computadora esté conectada a la misma red que el dispositivo Android
TV.
En la computadora, en una terminal, inicializa el puerto para TCP/IP. Para ello, sigue estos pasos:
ingresando lo siguiente:
adb tcpip 5555
Quita el cable USB y, luego, ingresa lo siguiente en la terminal:
adb connect Android TV device IP address:5555
Si tu dispositivo tiene un problema de desarrollador de Android TV, haz lo siguiente:
Asegúrate de que la computadora esté conectada a la misma red que tu dispositivo Android.
TV.
Abre una terminal e ingresa lo siguiente:
adb connect Android TV device IP address:4321
En Android TV, en el diálogo ¿Permitir depuración por USB?, selecciona Siempre.
permitir en esta computadora y selecciona Aceptar. Puedes verificar la conexión
y de que el dispositivo Android TV se comunique a través del
la red con el siguiente comando:
[null,null,["Última actualización: 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 ```"]]
