La pantalla principal de Android TV muestra contenido recomendado con canales y programas. Los canales se muestran como filas individuales en la pantalla principal, con tarjetas que muestran todos los programas disponibles para ese canal.
Tu app debe tener al menos un canal. El primer canal que crea tu app se convierte en su canal predeterminado, y Android TV lo muestra automáticamente en la pantalla principal. Tu app puede ofrecer otros canales, pero el usuario debe seleccionarlos y aprobarlos antes de que se agreguen a la pantalla principal.
Si tu app incluye programas de TV, películas o cualquier otro contenido de video, te recomendamos que admitas las vistas previas de video y que la integres con el canal mirar a continuación. El sistema Android controla este canal. Tu app puede agregar programas relacionados con el usuario a este canal, como programas que el usuario marcó como interesantes, que dejó de mirar por la mitad o que están relacionados con el contenido que está mirando (como el siguiente episodio de una serie o la siguiente temporada de un programa).
Cómo garantizar compatibilidad
La pantalla principal muestra recomendaciones de dos maneras diferentes según la versión de Android:
- En Android 8.0 (nivel de API 26) y versiones posteriores, las apps pueden mostrar recomendaciones en uno o más canales que aparecen en filas separadas. Siempre aparece un canal (el predeterminado). El usuario puede descubrir y agregar los otros canales a su pantalla principal. Obtén información para crear canales de recomendaciones en la pantalla principal.
- Antes de Android 8.0, Android TV mostraba todas las recomendaciones en una sola fila de recomendaciones que siempre aparecía en la pantalla. Obtén más información para crear la fila de recomendaciones en la pantalla principal.
Para poder mostrar recomendaciones en todas las versiones de Android TV, tu app debe implementar ambas APIs de recomendaciones. Prueba el nivel de API del sistema actual y usa la API adecuada para compilar la fila o los canales de recomendaciones.
if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { // Use the home screen recommendation channels API. } else { // Use the recommendations row API. }
Si tu app se compiló con el nivel de API 25 o anterior, aún se puede ejecutar en Android TV en el nivel 26. El comportamiento de las recomendaciones anteriores es compatible con versiones futuras, pero está limitado:
- La fila de recomendaciones se convierte automáticamente y aparece como un canal nuevo en la pantalla principal.
- Los programas del canal convertido responden a las actualizaciones de tu servicio de recomendaciones, pero el usuario no puede usar la IU de la TV para manipular los programas del canal (agregar o quitar programas, o copiarlos en el canal Ver a continuación).
- Si actualizas la app al nivel de API 26, el canal convertido seguirá apareciendo en las TVs que ejecuten la API 26. La TV quita el canal convertido de la pantalla la primera vez que tu app muestra un canal creado con la nueva API. Esto sucede de inmediato si la app crea un canal predeterminado o más tarde, cuando el usuario selecciona y agrega cualquier otro canal creado por tu app.