Los usuarios tienen diferentes expectativas cuando miran televisión que cuando usan un teléfono o una tablet. Un usuario de TV típico se sienta a aproximadamente 3 metros de distancia de la pantalla, por lo que los detalles pequeños son menos perceptibles y el texto pequeño resulta difícil de leer. Dado que los usuarios se sientan lejos de la TV, en lugar de tocar los elementos que aparecen en pantalla, deben usar un control remoto para navegar y realizar selecciones. Esas diferencias afectan de forma significativa los requisitos de lo que sería una buena experiencia del usuario de TV.
El primer paso para crear una experiencia excelente para los usuarios de TV es revisar y seguir los lineamientos de diseño para Android TV. Para comprender los requisitos básicos de implementación de una app para TV, también consulta el entrenamiento sobre la compilación de apps para TV.
Para obtener información sobre cómo publicar tus apps para TV en Google Play, consulta Cómo distribuir tus apps para Android TV.
Diseño visual e interacción del usuario
Los siguientes criterios ayudan a garantizar que tu app cumpla con los patrones fundamentales de diseño e interacción para brindar una experiencia del usuario coherente, intuitiva y agradable en dispositivos de TV.
| Tipo | prueba | Descripción |
|---|---|---|
| Selector | TV-LM |
La app exhibe un ícono de launcher de Android TV después de la instalación. Para obtener más información, consulta Cómo declarar una actividad de TV. |
| TV-LB |
La app muestra un banner de tamaño completo de 320 px x 180 px y, al menos, un ícono de la app de 160 px x 160 px (en densidad |
|
| TV-BN |
El banner de inicio de la app contiene el nombre de la app. |
|
| TV-LG |
Si la app es un juego, aparece en la fila Juegos del launcher de Android TV. |
|
| TV-LS |
La app se ejecuta correctamente y sin mensajes de error, incluso durante la instalación, la carga y las pruebas. Para obtener más información, consulta Cómo ejecutar apps para TVs. |
|
| Diseño | TV-LO |
Todas las interfaces de la app se presentan en orientación horizontal y sin formato de pantalla ancha o de pantalla vertical. Solo se puede usar el color negro para las barras de los videos en formato original. Para obtener más información, consulta Cómo compilar diseños básicos para TV. |
| TV-OV |
La app no muestra texto ni funcionalidades que estén parcialmente cortados por los bordes de la pantalla. Para obtener más información, consulta Overscan. |
|
| TV-TR |
La app no se superpone parcialmente con otras apps. La app ocupa toda la pantalla y tiene un fondo que no es transparente. |
|
| Navigation | TV-DP |
La funcionalidad de la app es navegable con los controles del pad direccional de cinco direcciones, a menos que la app requiera un control de juegos, como se especifica en el criterio TV-GP de la sección Controles de la siguiente tabla de Funcionalidad. Para obtener más información, consulta Navegación para TV. |
| TV-DK |
Si la app requiere un control de juegos, como se especifica en el criterio TV-GP, se puede navegar por toda la funcionalidad con las teclas de un control de juegos estándar para Android. Para obtener más información, consulta Cómo procesar la presión de los botones del control de juegos. |
|
| TV-DM |
La app no requiere que el dispositivo de control remoto tenga un botón de menú para acceder a los controles de la interfaz de usuario. |
|
| TV-DB |
Presiona el botón Atrás para regresar a la pantalla principal de Android TV. Para obtener más información, consulta Proporciona el comportamiento adecuado del botón Atrás. |
|
| TV-DL |
Si la app tiene un feed de TV en vivo integrado en la pestaña En vivo, cumple con los requisitos de reproducción sin interrupciones y transmisión directa. Para obtener más información, consulta Botón Atrás. |
|
| Buscar | TV-SB |
El resultado de la búsqueda dentro de la app aparece en el cuadro de búsqueda, de forma similar a lo que brinda la interfaz de usuario provista por |
Funcionalidad y rendimiento
Estos criterios garantizan que tu app esté configurada correctamente y proporcione el comportamiento funcional previsto.
| Tipo | prueba | Descripción |
|---|---|---|
| SDK | TV-PS |
Además de los requisitos básicos de rendimiento y estabilidad, la app declara compatibilidad con dispositivos Android TV de uso común estableciendo una versión mínima del SDK de Android de 31 o inferior estableciendo el valor minSdkVersion.
|
| Manifest | TV-ML |
El manifiesto de la app establece un tipo de intent |
| TV-MT |
El manifiesto de la app establece la función de hardware |
|
| Controles de juegos | TV-GP |
Si en la app se usa un control de juegos como método de entrada principal, esta declara el requisito correspondiente con la etiqueta del manifiesto |
| TV-GC |
Si la app proporciona instrucciones visuales para usar controles de juegos, las instrucciones no deben contener recursos de marca y deben mostrar un diseño de botones compatible. Para obtener más información, consulta Cómo controlar los mandos de juegos. |
|
| Publicidad | TV-AP |
La app ofrece interacción con publicidad a través de los controles del pad direccional. Para obtener más información, consulta Habilita la navegación con el pad direccional. |
| TV-AD |
Para la publicidad que utilice anuncios en pantalla completa que no sean de video, la app le permitirá al usuario descartar de inmediato el anuncio con los controles del pad direccional o del gamepad. |
|
| TV-AU |
Para la publicidad que utilice anuncios con posibilidad de hacer clics, que no ocupen la pantalla completa y que no sean de video, la app no permitirá que estos vinculen a una URL web. |
|
| TV-AA |
Para la publicidad que utilice anuncios con posibilidad de hacer clics, que no ocupen la pantalla completa y que no sean de video, la app no permitirá que estos vinculen a otra app que no esté disponible en dispositivos de TV. |
|
| Contenido web | TV-WB |
Para el contenido web, la app solo puede usar componentes |
| Reproducción de contenido multimedia | TV-NP |
Si la app continúa reproduciendo audio después de que el usuario regresa a la pantalla principal o cambia a otra app, la app proporciona una tarjeta En reproducción en la fila de recomendación de la pantalla principal para que los usuarios puedan regresar a ella y controlar la reproducción. Para obtener más información, consulta Cómo mostrar una tarjeta de Está sonando. Te recomendamos que pauses el video cuando el usuario salga de la app y que no integres el video con la tarjeta Reproduciendo ahora. |
| TV-PA |
Si la app proporciona una tarjeta En reproducción, cuando el usuario la seleccione, pasará a una pantalla que le permitirá pausar la reproducción. |
|
| TV-PP |
Si la app reproduce contenido de video o música, alternará entre la reproducción y la pausa del contenido multimedia cuando se envíe un evento clave de reproducción o pausa durante la reproducción.
Para obtener más información, consulta
|
|
| TV-PC |
Mientras se reproduce un video o audio, al presionar el botón central del pad direccional, se pausa el contenido multimedia en reproducción. Cuando se pausa la reproducción, al presionar el botón central del pad direccional, se reanuda la reproducción. Los botones izquierdo y derecho del pad direccional adelantan y retroceden la pista actual, respectivamente. Para obtener más información, consulta Eventos de medios. |
|
| TV-PN |
Los elementos se agregan al canal Ver a continuación según los lineamientos de Ver a continuación para desarrolladores de apps. |
|
| Modo ambiente | TV-BU |
Cuando hay una reproducción de video activa iniciada por el usuario, la app evita que el dispositivo entre en Modo ambiente. Para obtener más información, consulta Modo ambiente. |
| TV-BY |
Cuando no hay animaciones o reproducciones de video activas iniciadas por el usuario, la app no evita que el dispositivo entre en Modo ambiente. |
|
| TV-BA |
Para reproducir solo audio, la app no debe evitar que el dispositivo entre en Modo ambiente, a menos que implemente una experiencia de imágenes no estáticas, como videos musicales o imágenes, mientras se reproduce música. |
|
| Memoria | ||
| TV-ME |
En el caso de los dispositivos con poca RAM (en los que ActivityManager.isLowRamDevice() devuelve verdadero), el uso máximo de memoria (Anónima+Swap + Gráficos + Memoria de archivo) de una app en primer plano debe permanecer dentro de los límites (incluidos los mecanismos de medición y las advertencias específicos) definidos en Optimiza el uso de la memoria. |
Google Play
Sigue estos requisitos para configurar tu app de forma coherente con otras fichas y clasificaciones en Google Play:
| Tipo | prueba | Descripción |
|---|---|---|
| Pantalla en pantalla | TV-IC |
La app establece los metadatos adecuados para categorizar su uso del modo de pantalla en pantalla en uno de los tipos de uso permitidos. También declara un título y un subtítulo que representan con precisión para qué se usa este PIP. Para obtener más información, consulta Cómo realizar varias tareas a la vez en la TV. |
| TV-IP |
Mientras está en modo de pantalla en pantalla, la app no muestra material promocional ni publicidad que no forme parte inherente de la fuente de contenido. |
|
| TV-IQ |
Mientras está en modo de pantalla en pantalla, la app no degrada la experiencia de otra actividad de pantalla completa. La app no debe usar recursos excesivos, tomar el control del foco de audio, interferir en la MediaSession activa ni solicitar una cantidad desproporcionada de sesiones de decodificador. |
|
| TV-IH |
La app no muestra controles de la IU ni elementos navegables en el modo de pantalla en pantalla. Las apps pueden exponer ciertos controles del usuario directamente en la ventana de PiP. |
|
| TV-IE |
Para ingresar al modo de PIP, el usuario debe realizar una acción explícita y deliberada dentro de la app. La app no ingresa automáticamente al modo de PIP ( |
|
| TV-IS |
La app no debe mostrar ninguna IU para ingresar al modo PIP si el modo de pantalla en pantalla está inhabilitado en un dispositivo. |
|
| TV-IX |
La app usa el modo de pantalla en pantalla solo para continuar una actividad en curso. La experiencia de imagen en imagen no incentiva ni alienta a los usuarios a volver a la vista de pantalla completa de la app durante la actividad en curso o después de que haya finalizado. |
|
| Políticas de Play | TV-G1 |
El uso de Android App Bundles es obligatorio para todas las apps para TVs nuevas y existentes en Google Play Store. |
| TV-G2 |
Tu app debe cumplir con los requisitos del Centro de políticas para desarrolladores de Play. |
|
| Página de detalles de la app | TV-G3 |
La app funciona según lo previsto o lo descrito en la ficha de Google Play Store. |
| TV-G4 |
En el envío de la app, se subió al menos una captura de pantalla de alta resolución y sin cambios que representa con exactitud la versión actual de la experiencia de la app para TV. |
|
| Credenciales de acceso | TV-G5 |
En el caso de las apps con funciones pagadas, debes proporcionar credenciales de acceso en Google Play Console para probar la experiencia completa de la app. Para obtener más información, consulta Acceso a la app en Prepara tu app para la revisión. |
Preguntas frecuentes
Después de enviar mi app, ¿cómo sabré si no cumple con todos los requisitos para dispositivos de TV?
Si tu app no cumple con los requisitos de usabilidad que se describen en esta página, el equipo de Play Store se comunicará contigo a la dirección de correo electrónico que especificaste en la cuenta de Google Play Console asociada a la app.
Precaución: Asegúrate de que tu app incluya las entradas obligatorias del manifiesto para dispositivos de TV. De lo contrario, no se considerará una app para TV y no se revisará en virtud de los requisitos de usabilidad para TV.
Mi app está orientada a factores de forma que no son solo dispositivos de TV. Si mi app no cumple con los requisitos de dispositivos de TV, ¿aparecerá mi app nueva o actualizada en Google Play para otros dispositivos?
Las actualizaciones de la ficha de Play Store solo se pueden publicar si se aprueban todos los cambios. Si la actualización de un artefacto específico para un factor de forma impide que se realicen más actualizaciones en tu ficha para otros dispositivos, como teléfonos o tablets, es posible que desees quitar ese artefacto reemplazándolo por un envío vacío hasta que puedas cumplir con los requisitos.
Si mi app cumple con los requisitos de publicación, ¿cuándo estará disponible en Google Play Store para dispositivos de TV?
Las apps que cumplan con los requisitos aparecerán en Play Store para dispositivos de TV al instante.