Recomendar conteúdo na tela inicial

A tela inicial do Android TV exibe o conteúdo recomendado usando canais e programas. Os canais são exibidos como linhas individuais na tela inicial, com cards que exibem todos os programas disponíveis para o canal.

Seu app precisa ter pelo menos um canal. O primeiro canal criado no seu app se torna o canal padrão, e a Android TV exibe esse canal automaticamente na tela inicial. Outros canais podem ser oferecidos pelo seu app, mas o usuário precisa selecionar e aprovar esses canais antes de adicioná-los à tela inicial.

Caso seu app apresente programas de TV, filmes ou outro conteúdo de vídeo, recomendamos que você ofereça compatibilidade com vídeos de prévia e se integre ao canal "Assistir a seguir". O canal "Assistir a seguir" é controlado pelo sistema Android. Seu app pode adicionar programas relacionados com o usuário a esse canal, por exemplo, aqueles que o usuário marcou como interessantes, que ele parou de assistir no meio ou programas que estejam relacionados com conteúdo que o usuário está assistindo (como o próximo episódio de uma série ou a próxima temporada de um programa).

Garantir compatibilidade

A tela inicial exibe recomendações de duas maneiras diferentes, dependendo da versão do Android:

  • No Android 8.0 (API de nível 26) e versões mais recentes, os apps podem mostrar recomendações em um ou mais canais que aparecem em linhas separadas. Um canal (o canal padrão) sempre aparece. O usuário pode encontrar e adicionar os outros canais à tela inicial dele. Saiba como criar canais de recomendação na tela inicial.
  • Antes do Android 8.0, a Android TV mostra todas as recomendações em uma única linha de recomendações que sempre aparece na tela. Saiba como criar a linha de recomendações na tela inicial.

Para poder mostrar recomendações em todas as versões da Android TV, seu app precisa implementar as duas APIs de recomendação. Teste o nível atual da API do sistema e use a API apropriada para criar a linha ou os canais de recomendação.

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
    }
    

Se o app foi compilado usando a API de nível 25 ou anterior, ele ainda pode ser executado na Android TV no nível 26. O comportamento anterior para recomendações é compatível com versões futuras, mas com restrições:

  • A linha de recomendações é convertida automaticamente e aparece como um novo canal na tela inicial.
  • Os programas no canal convertido respondem a atualizações do seu serviço de recomendação, mas o usuário não pode usar a IU da TV para manipular os programas no canal (adicionar/remover programas, copiar programas para o canal "Assistir a seguir").
  • Se você atualizar o app para a API de nível 26, o canal convertido ainda aparecerá em TVs que executam essa API. A TV removerá o canal convertido da tela na primeira vez que seu app exibir um canal criado com a nova API. Isso acontecerá imediatamente se um canal padrão for criado no app ou mais tarde, quando o usuário selecionar e adicionar qualquer outro canal criado pelo seu app.