Recomendar conteúdo na tela inicial

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

Seu app precisa ter pelo menos um canal. O primeiro canal criado pelo app vai se tornar o canal padrão, e o Android TV vai mostrar esse canal automaticamente na tela inicial. Seu app pode oferecer outros canais, mas o usuário precisa selecionar e aprovar esses canais antes que eles sejam adicionados à tela inicial.

Caso seu app apresente programas de TV, filmes ou outro conteúdo de vídeo, recomendamos que você ofereça suporte a prévias de vídeo e faça a integração com o canal "Assistir a seguir". O canal "Assistir a seguir" é controlado pelo sistema Android. Seu app pode adicionar programas relacionados ao usuário a esse canal, como programas que o usuário marcou como interessantes, parou de assistir no meio ou que estão relacionados ao 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 (nível 26 da API) 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 descobrir e adicionar os outros canais à tela inicial. Saiba como criar canais de recomendação na tela inicial.
  • Antes do Android 8.0, o 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ção na tela inicial.

Para mostrar recomendações em todas as versões do 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 tiver sido compilado usando o nível 25 da API ou anterior, ele ainda poderá ser executado no Android TV no nível 26. O comportamento antigo das 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 interface 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 o nível 26 da API, o canal convertido ainda vai aparecer em TVs com a API 26. A TV vai remover o canal convertido da tela na primeira vez que o app mostrar um canal criado com a nova API. Isso acontecerá imediatamente se o app criar um canal padrão ou depois, quando o usuário selecionar e adicionar qualquer outro canal criado pelo app.