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.