Calidad de las apps para TVs

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 de implementación fundamentales de una app para TV, consulta también la capacitación sobre cómo crear 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 clave de diseño e interacción para garantizar 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 x 180 píxeles y, al menos, un ícono de app de 160 x 160 píxeles (con una densidad de xhdpi) como íconos de selector en el selector de Android TV. Para obtener más información, consulta los Lineamientos de íconos y banners de apps para Android TV.

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.
Para obtener más información, consulta Cómo mostrar tu juego en la pantalla principal.

TV-LS

La app se ejecuta correctamente y sin mensajes de error, incluso durante la instalación, carga y prueba. Para obtener más información, consulta Cómo ejecutar apps para TV.

Diseño TV-LO

Todas las interfaces de la app se presentan en orientación horizontal y sin formato de pantalla ancha vertical ni formato pillarbox. 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 de 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 Superposición.

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.

TV-DP

La funcionalidad de la app es navegable mediante 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 Controladores 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 las teclas de los botones de los controles 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, la app cumple con los requisitos de reproducción sin interrupciones y transmisión directa. Para obtener más información, consulta Botón Atrás.

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 SearchFragment, y los resultados son relevantes para esa búsqueda. Para obtener más información, consulta Cómo realizar búsquedas en apps para TV.

Funcionalidad y rendimiento

Estos criterios garantizan que tu app esté configurada correctamente y proporcione el comportamiento funcional previsto.

Tipo prueba Descripción
Manifiesto TV-ML

El manifiesto de la app establece un tipo de intent ACTION_MAIN con la categoría CATEGORY_LEANBACK_LAUNCHER. Para obtener más información, consulta Cómo declarar una actividad de TV.

TV-MT

El manifiesto de la app establece la función de hardware android.hardware.touchscreen y otras que se enumeran en "Cómo declarar los requisitos de hardware para TV" como no obligatorias. Para obtener más información, consulta Cómo declarar los requisitos de hardware para TV.

Controles para 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 <uses-feature>. Para obtener más información, consulta Cómo declarar la compatibilidad con los controles de juegos.

TV-GC

Si la app proporciona instrucciones visuales para el uso de controles de juegos, las instrucciones no deben contener recursos de marca y deben exhibir un diseño de botones compatible. Para obtener más información, consulta Cómo controlar los controles de juegos.

Publicidad TV-AP

La app ofrece interacción con anuncios publicitarios mediante el uso 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 permite al usuario descartar de inmediato el anuncio con los controles del pad direccional o del mando de juegos.

TV-AU

Para la publicidad que utilice anuncios que admitan clics, que no ocupen la pantalla completa y que no sean de video, la app no permite que los anuncios dirijan a una URL web.

TV-AA

Para la publicidad que utilice anuncios que admitan clics, que no ocupen la pantalla completa y que no sean de video, la app no permite que los anuncios dirijan 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 WebView. Es posible que la app no intente iniciar una app de navegador web.

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 Reproduciendo ahora en la fila de recomendación de la pantalla principal de modo 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 no lo integres 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 KEYCODE_MEDIA_PLAY_PAUSE.

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 la reproducción está pausada, presionar el botón central del pad direccional la reanuda. Los botones izquierdo y derecho del pad direccional adelantan y retroceden la pista actual, respectivamente. Para obtener más información, consulta Eventos multimedia.

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 la reproducción de solo audio, la app no evita 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() muestra un valor verdadero), el uso máximo de memoria (Anon+Swap + Graphics + File Memory) de una app en primer plano debe mantenerse dentro de los límites (incluidos los mecanismos de medición y las advertencias específicos) definidos en Cómo optimizar 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 de la función 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 pantalla en pantalla, la app no muestra material promocional ni publicidad que no forme parte de la fuente de contenido.

TV-IQ

Mientras está en el modo de pantalla en pantalla, la app no degrada la experiencia de otra actividad de pantalla completa.

La app no debe usar recursos excesivos, apropiarse del foco de audio, interferir con la MediaSession activa ni solicitar una cantidad desproporcionada de sesiones de decodificador.

TV-IH

La app no muestra ningún control de la IU ni elementos navegables mientras está en el modo de pantalla en pantalla. Las apps pueden exponer ciertos controles de usuario directamente en la ventana de PiP.

TV-IE

Para ingresar al modo de imagen en imagen, el usuario debe realizar una acción explícita e intencional dentro de la app. La app no ingresa automáticamente al modo PiP (setAutoEnterEnabled establecido en false) a menos que el usuario esté en una llamada en curso.

TV-IS

La app no debe mostrar ninguna IU para ingresar al modo PIP si este 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 pantalla en pantalla 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 esta 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 descrito en la ficha de Google Play Store.

TV-G4

El envío de la app subió al menos una captura de pantalla de alta resolución sin cambios que represente 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 de apps 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á como 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 distintos de los dispositivos de TV. Si mi app no cumple con los requisitos de TV, ¿aparecerá mi app nueva o actualizada en Google Play para otros dispositivos?

Las actualizaciones de tu ficha de Google Play Store solo se pueden publicar si se aprueban todos los cambios. Si una actualización de un artefacto específico del factor de forma bloquea otras actualizaciones de tu ficha para otros dispositivos, como teléfonos o tablets, te recomendamos que quites ese artefacto y lo reemplaces 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.