Cómo recomendar contenido en la pantalla principal

En la pantalla principal de Android TV, se muestra contenido recomendado mediante 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 u otro contenido de video, te recomendamos que admitas vistas previas de videos y las integres con el canal Ver a continuación. El sistema Android controla este canal. Tu app puede agregar programas relacionados con el usuario a este canal, como aquellos que el usuario marcó como interesantes, los que dejó de mirar por la mitad o los relacionados con el contenido que está mirando (como el siguiente episodio de una serie o la próxima temporada de un programa).

Cómo garantizar compatibilidad

En la pantalla principal, se muestran 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 canal predeterminado). El usuario puede descubrir y agregar los otros canales a su pantalla principal. Obtén información sobre cómo crear canales de recomendaciones en la pantalla principal.
  • En las versiones anteriores a Android 8.0, Android TV muestra todas las recomendaciones en una sola fila de recomendaciones que siempre aparece en la pantalla. Obtén información sobre cómo 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 recomendación.

Kotlin

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

Java

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 un nivel de API 25 o anterior, aún puede ejecutarse en Android TV en el nivel 26. El antiguo comportamiento de las recomendaciones es compatible con versiones posteriores, pero tiene las siguientes restricciones:

  • 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, copiar programas en el canal Ver a continuación).
  • Si actualizas la app al nivel de API 26, el canal convertido aparecerá en las TVs que ejecutan el nivel de API 26. La TV quita el canal convertido de la pantalla la primera vez que tu app muestra un canal creado con la API nueva. Esto sucede de inmediato si la app crea un canal predeterminado o más adelante cuando el usuario selecciona y agrega cualquier otro canal que cree la app.