Recomendar conteúdo na tela inicial

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

Seu app precisa ter pelo menos um canal. O primeiro canal criado pelo app se torna o canal padrão, e o Android TV o exibe 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.

Se o app tiver 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. O 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 mostra 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 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 mostrava todas as recomendações em uma única linha que sempre aparecia 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, o app precisa implementar as duas APIs de recomendação. Teste o nível da API do sistema atual e use a API adequada para criar a linha ou os canais de recomendação.

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // Use the home screen recommendation channels API.
} else {
    // Use the recommendations row API.
}
Recommendations.kt

Se o app foi 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 mais recentes, mas limitado:

• A linha de recomendações é convertida automaticamente e aparece como um novo canal na tela inicial.
• Os programas no canal convertido respondem às 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 o nível 26 da API, o canal convertido ainda vai aparecer em TVs com a API 26. A TV remove o canal convertido da tela na primeira vez que o app mostra um canal criado com a nova API. Isso acontece imediatamente se o app criar um canal padrão ou mais tarde, quando o usuário selecionar e adicionar qualquer outro canal criado pelo app.