Calidad de las apps para TVs

Los usuarios tienen diferentes expectativas 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 experiencia excelente para los usuarios de TV es revisar y seguir los lineamientos de diseño de Android TV. Si quieres 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.

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 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 para TV.

TV-LB

La app muestra un banner de tamaño completo de 320 x 180 píxeles y un ícono de la app de, al menos, 160 x 160 píxeles (en densidad xhdpi) como sus íconos de selector en el selector de Android TV. Para obtener más información, consulta los lineamientos sobre í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 Muestra tu juego en la pantalla principal.

TV-LS

La app se ejecuta de forma 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. 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 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 Sobrebarrido.

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 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 un 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 inconvenientes y transmisión directa. Para obtener más información, consulta Botón Atrás.

TV-SB

Una búsqueda dentro de 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. (si deseas 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 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 para TV.

TV-MT

El manifiesto de la app establece como no obligatoria la función de hardware android.hardware.touchscreen y otras que se mencionan en "Cómo declarar los requisitos de hardware para TV". 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>. 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 incluirán recursos de marca y mostrarán un diseño de botones compatible. Para obtener más información, consulta Cómo administrar los controles para juegos.

Publicidad TV-AP

La app ofrece interacción con la 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 de 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 utiliza 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. 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 vuelve a la pantalla principal o cambia a otra app, la app proporciona una tarjeta de Está sonando en la fila de recomendación de la pantalla principal para que los usuarios puedan regresar a la app 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 lo integres con la tarjeta de Está sonando.

TV-PA

Si la app proporciona una tarjeta de Está sonando, cuando el usuario la seleccione, se lo dirigirá 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 en reproducción. Cuando se pausa la reproducción, se reanuda la acción de presionar el botón central del pad direccional. Los botones izquierdo y derecho del pad direccional permiten avanzar y retroceder 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

Para 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 Pruebas Descripción
Pantalla en pantalla TV‐IC

La app establece los metadatos adecuados para categorizar su uso de pantalla en pantalla en uno de los tipos de uso permitidos. También declara un título y 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.

IP de TV

Cuando se usa la función de pantalla en pantalla, la app no muestra material promocional ni publicidad que no sea intrínsecamente parte de la fuente del 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, tomar el foco de audio, interferir en 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 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 pantalla en pantalla, se requiere una acción explícita e intencional por parte del usuario dentro de la app. La app no ingresa automáticamente a 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 a 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 la continuación de una actividad en curso. Esta experiencia no incentiva ni alienta a los usuarios a volver a la vista de pantalla completa de la app durante la actividad en curso ni después de que haya concluido.

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 app TV-G3

La app funciona según lo previsto o lo 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 modificar 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 la app incluya las entradas del manifiesto obligatorias para dispositivos de TV. De lo contrario, no se considerará como una app para TV y no se revisará a fin de comprobar los requisitos de usabilidad para TVs.

Mi app se orienta a factores de forma que no son solo dispositivos de TV. Aun si mi app nueva o actualizada no cumple con los requisitos de TV, ¿aparecerá en Google Play para otros dispositivos?

Las actualizaciones de la ficha de Google Play Store solo se pueden publicar si se aprueban todos los cambios. Si la actualización de un artefacto específico de un factor de forma bloquea más actualizaciones en tu ficha para otros dispositivos, como teléfonos o tablets, te recomendamos que lo reemplaces por un envío vacío hasta que puedas abordar los requisitos para quitar ese artefacto.

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.