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 en las que aparecen los programas disponibles para ese canal.

Tu app debe tener al menos un canal. El primer canal que esta crea se convierte en su canal predeterminado y Android TV lo muestra automáticamente en la pantalla principal. Puede ofrecer otros canales, pero el usuario deberá 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, por ejemplo, aquellos que el usuario marcó como interesantes, los que dejó 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 (API nivel 26) y versiones posteriores, las apps pueden mostrar recomendaciones en uno o varios canales que aparecen en filas separadas. Siempre aparece un canal (el canal predeterminado). El usuario puede buscar y agregar 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 que siempre está visible en la pantalla. Obtén información sobre cómo crear la fila de recomendaciones en la pantalla principal.

Si quieres mostrar recomendaciones en todas las versiones de Android TV, tu app debe implementar ambas API de recomendaciones. Prueba el nivel de API actual del sistema y usa la API apropiada a fin de crear los canales o la fila de recomendaciones.

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 la API nivel 25 o una versión anterior, de igual manera puede ejecutarse en un Android TV con la API 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 ni copiar programas en el canal "Ver a continuación").
  • Si actualizas la app al nivel de API 26, el canal convertido igualmente aparecerá en las TV que ejecuten la API nivel 26. La TV quita el canal convertido de la pantalla la primera vez que tu app muestra un canal creado con la API nueva. Esta modificación se realiza inmediatamente si la app crea un canal predeterminado o más tarde si el usuario selecciona y agrega otro canal que crea tu app.