Recomendar conteúdo na tela inicial

A tela inicial do Android TV mostra 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 que seu que o app cria se torna o canal padrão dele, e o Android TV vai mostrar esse canal automaticamente na tela inicial. Seu app podem oferecer outros canais, mas o usuário precisa selecionar e aprovar esses canais antes de serem adicionadas à tela inicial.

Se o app apresentar programas de TV, filmes ou outro conteúdo de vídeo, recomendamos que você faça o seguinte: você oferece suporte para prévias de vídeos e fazer 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 para este 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 do Android:

  • No Android 8.0 (nível 26 da API) e versões mais recentes, os apps podem mostrar recomendações de uma ou mais canais que aparecem em linhas separadas. Um canal (o canal padrão) sempre aparece. O usuário pode descobrir e adicionar outros canais à página inicial tela. 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 o linha de recomendações na página inicial tela.

Para poder mostrar recomendações em todas as versões do Android TV, seu app deve implementar as duas APIs de recomendação. Teste o nível atual da API do sistema e usar 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 seu app foi compilado usando uma API de nível 25 ou anterior, ele ainda pode ser executado em Android TV no nível 26. O comportamento antigo é compatível com versões futuras, mas restrito:

  • A linha de recomendações é convertida automaticamente e aparece como uma nova na tela inicial.
  • Os programas no canal convertido respondem a atualizações de sua serviço de recomendação, mas o usuário não pode usar a interface da TV para manipular os programas no canal (adicione/remova programas, copie programas para o canal "Assistir a seguir").
  • Se você atualizar o app para o nível 26 da API, o canal convertido ainda aparece em TVs com a API 26. A TV remove o canal convertido na tela na primeira vez que seu aplicativo exibir um canal criado com a nova API. Isso acontece imediatamente se o app criar uma default channel, ou depois, quando o usuário selecionar e adicionar qualquer outro canal criado pelo seu app.
.