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.
- Registra tu dispositivo Android TV en Play Console de Google Cast, como que se describe en Registro de dispositivos
Depuración
Para probar y depurar tu aplicación receptora web en tu dispositivo Android TV, haz lo siguiente: lo siguiente:
- Registra tu dispositivo Android TV y tu aplicación en el Consola para desarrolladores del SDK de Google Cast. Consulta Registro para obtener más información sobre el registro de dispositivos y aplicaciones.
- Inicia tu aplicación emisora y transmite al dispositivo Android TV.
- Conéctate a tu dispositivo Android TV a través de ADB, como se describe en Cómo usar Android Debug Bridge
- En tu máquina de desarrollo, abre una ventana del navegador Chrome y ve a chrome://inspect. .
- Haz clic en el vínculo inspect para incorporar Web Receiver al depurador.
En la consola de Chrome Remote Debugger, habilita el registro de depuración ingresando el lo siguiente:
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
Consulta Depuración para obtener más información.
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, comotimeupdate,pauseywaiting. Evita usar eventos relacionados con las herramientas de redes, comoprogress,suspendystalled, 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:
- En tu dispositivo Android TV, habilita las opciones para desarrolladores como se describe en Configuración para el desarrollo.
- 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:
- Configura tu dispositivo Android TV para desarrollo, como se describe en Configuración para el desarrollo.
- 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.
- Configura tu dispositivo Android TV para desarrollo, como se describe en Configuración para el desarrollo.
- En Android TV, en la fila Device, selecciona Network > Wi-Fi y selecciona la red conectada.
- Selecciona Información de estado y anota la dirección IP.
Si tu dispositivo es un dispositivo Android TV estándar de venta minorista, haz lo siguiente:
- Sigue los pasos que se indican Cómo usar adb con un cable USB.
- 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:
adb logcat