Calidad de las apps para TVs

Los usuarios tienen expectativas diferentes cuando miran TV 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 gran experiencia para usuarios de TV es revisar y seguir los lineamientos de diseño de Android TV. Para comprender los requisitos básicos de implementación de una app para TV, consulta también la capacitación Cómo compilar apps para TV.

Importante: Para garantizar una excelente experiencia del usuario, las apps para dispositivos de TV deben cumplir determinados requisitos de usabilidad. Solo las apps que cumplan con los criterios de calidad que se indican en esta página califican como apps para Android TV en Google Play.

Para obtener información acerca de cómo publicar tus apps para TV en Google Play, consulta Cómo distribuir tus apps para Android TV.

Interacción del usuario y diseño visual

Los siguientes criterios ayudan a garantizar que tu app cumpla con los patrones clave de interacción y diseño para ofrecer una experiencia del usuario uniforme, intuitiva y agradable en dispositivos de TV.

Tipo Cómo realizar pruebas 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 la app de 160 x 160 píxeles (en densidad xhdpi) como íconos de selector en el Selector de Android TV. Para obtener más información, consulta los lineamientos para íconos y banners de apps de 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 de manera correcta y sin mensajes de error, incluso durante la instalación, la carga y las pruebas. Si deseas 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 letterbox ni pillarbox vertical. Solo se puede usar el color negro en 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 Reemplazo.

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 se puede navegar 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 de TV-GP en la sección Controles de la tabla de funciones siguiente. Para obtener más información, consulta Navegación en 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 las pulsaciones 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.

TV-SB

Una búsqueda en la app aparece en el cuadro de búsqueda, de manera similar a la interfaz de usuario que proporciona 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

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

Tipo Cómo realizar pruebas 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 como no obligatorias la función de hardware android.hardware.touchscreen y otras que se indican en "Cómo declarar los requisitos de hardware para TV". Para obtener más información, consulta Cómo declarar 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>. Si deseas 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 usar controles de juegos, las instrucciones no contienen marcas y muestran un diseño de botones compatible. Para obtener más información, consulta Cómo controlar los controles para juegos.

Publicidad TV-AP

La app ofrece interacción con publicidad mediante los controles del pad direccional. Para obtener más información, consulta Cómo habilitar 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 de un pad direccional o un control de juegos.

TV-AU

Para la publicidad que utilice anuncios en los que se puede hacer clic, que no son de pantalla completa y que no son de video, la app no permite que los anuncios vinculen a una URL web.

TV-AA

Para la publicidad que utilice anuncios en los que se puede hacer clic, que no son de pantalla completa y que no son de video, la app no permite que los anuncios vinculen a otra app que no está disponible para dispositivos de TV.

Contenido web TV-WB

Para el contenido web, la app solo puede usar componentes WebView. La app no puede intentar iniciar una app de navegador web.

Reproducción de contenido multimedia TV-NP

Si la app continúa reproduciendo sonido después de que el usuario regresa a la pantalla principal o cambia a otra app, la app proporcionará una tarjeta Está sonando en la fila de recomendación de la pantalla principal para que los usuarios puedan volver a ella y controlar la reproducción. Para obtener más información, consulta Cómo mostrar una tarjeta de Está sonando.

TV-PA

Si la app proporciona una tarjeta de Está sonando, 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 reproducir y pausar la reproducción de 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, si presionas el botón central del pad direccional, se pausa el contenido multimedia. Cuando se pausa la reproducción, se reanuda el botón central del pad direccional. 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 impide que el dispositivo entre en Modo ambiente.

TV-BA

En el caso de la reproducción de solo audio, la app no impide 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 la música.

Google Play

Sigue estos requisitos para configurar tu app de manera coherente con otras fichas y clasificaciones de Google Play:

Tipo Cómo realizar pruebas Descripción
Políticas de Play TV-G1

El uso de Android App Bundles es obligatorio para todas las apps para TV 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 aplicación TV-G3

Las funciones de la app se comportan según lo previsto o descrito en la ficha de Google Play Store de la app.

TV G4

El envío de la app subió al menos una captura de pantalla de alta resolución sin alteraciones que muestra con exactitud la versión actual de la experiencia de tu 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 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á que tu app es para TV y no se revisará a fin de determinar si cumple con los requisitos de usabilidad para TVs.

Mi app está orientada a otros dispositivos además de los de TV. Aun si mi app nueva o actualizada no cumple con los requisitos de TV, ¿aparecerá en Google Play para otros dispositivos?

Sí. Los requisitos que se describen en esta página solo son necesarios para la distribución a Google Play en dispositivos de TV. No se verá afectada la distribución a otros tipos de dispositivos, como teléfonos o tablets.

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.