Cómo recomendar contenido en la pantalla principal

La pantalla principal de Android TV muestra contenido recomendado mediante canales y programas. Los canales se muestran como filas individuales en la pantalla de inicio, con tarjetas que muestran todos los programas disponibles para ese canal.

Tu app debe tener al menos un canal. El primer canal que que crea la app se convierte en su canal predeterminado, Android TV lo mostrará 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 la app incluye programas de TV, películas u otro contenido de video, te recomendamos lo siguiente: Se admiten las vistas previas de video y integrarlos en 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 los programas que el usuario marcó como interesantes, dejaron de mirar por la mitad o están relacionadas con el contenido que el usuario está mirando (como el siguiente episodio de una serie o la próxima temporada de un programa).

Cómo garantizar compatibilidad

La pantalla de inicio muestra recomendaciones de dos maneras diferentes según el versión de Android:

  • En Android 8.0 (nivel de API 26) y versiones posteriores, las apps pueden mostrar recomendaciones en un más canales que aparecen en filas separadas. Un canal (el canal predeterminado) siempre aparece. El usuario puede descubrir y agregar los otros canales a su casa. en la pantalla. Obtén más información sobre cómo crear canales de recomendaciones en la pantalla de inicio.
  • En versiones anteriores a Android 8.0, Android TV muestra todas las recomendaciones en un solo lugar. recomendaciones que siempre aparece en la pantalla. Aprende a crear fila de recomendaciones en la página principal en la pantalla.

Para poder mostrar recomendaciones en todas las versiones de Android TV, tu app debería implementar ambas APIs de Recommendation. Prueba el nivel de API actual del sistema y usar la API adecuada para crear las filas de recomendaciones o los canales.

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 comportamiento anterior de las recomendaciones es compatible con versiones futuras pero con limitaciones:

  • La fila de recomendaciones se convierte automáticamente y aparece como un nuevo en la pantalla principal.
  • Los programas del canal convertido responden a las actualizaciones de tu servicio de recomendaciones pero el usuario no puede utilizar la interfaz de usuario de la TV para manipular los programas del canal (agregar o quitar programas, copiar programas al canal Ver a continuación)
  • Si actualizas la app al nivel de API 26, el canal convertido sigue apareciendo en TVs que ejecutan el nivel de API 26. La TV quita el canal convertido de la pantalla la primera vez que tu app muestre un canal creado con la nueva API. Esto sucede inmediatamente si la app crea canal predeterminado, o más adelante, cuando el usuario seleccione y agregue cualquier otro canal creado por tu aplicación.