Listas de verificação de apps para TV

Os usuários aproveitam a experiência do app de TV quando ela é consistente, lógica e previsível. Eles precisam conseguir navegar no seu app e pelo Android TV sem se perder ou ter que "redefinir" a IU e começar de novo. Os usuários gostam de interfaces claras, coloridas e funcionais que tornam a experiência mágica. Com isso em mente, você pode criar um app que se encaixa perfeitamente no Android TV e tem o desempenho esperado pelos usuários.

Essas listas de verificação abrangem os principais aspectos do desenvolvimento de apps e jogos para garantir que seu app ofereça a melhor experiência possível. Outras considerações apenas para jogos estão na seção Jogos.

Para conferir os critérios que qualificam um app para Android TV a ser distribuído pelo Google Play, consulte Qualidade do app para TV.

Suporte ao formato de TV

Estes itens da lista de verificação se aplicam a jogos e apps.

• Identifique a principal atividade para a TV com o filtro CATEGORY_LEANBACK_LAUNCHER no manifesto.
• Forneça um banner de tela inicial para cada idioma compatível com seu app, com as seguintes características:
  • O banner mede 320 x 180 px.
  • O recurso de banner está no diretório drawables/xhdpi.
  • A imagem do banner inclui texto localizado para identificação do app.
• Considere se o app precisa impedir que o dispositivo entre no Modo ambiente. Isso é particularmente relevante para apps de reprodução de mídia.
• Não declare um requisito para hardware que possa não ser compatível.
• As permissões não podem implicar requisitos de hardware.

Design da interface do usuário

Estes itens da lista de verificação se aplicam a jogos e apps.

• Especifique atividades com orientação paisagem definindo android:screenOrientation="landscape".
• Forneça recursos de layout adequados para o modo paisagem.
• Verifique se o texto e os controles são grandes o suficiente para serem visíveis de longe.
• Forneça bitmaps e ícones de alta resolução para telas HDTV.
• Verifique se os ícones e o logotipo estão em conformidade com as especificações da Android TV.
• Permita o overscan no seu layout.
• Ao reproduzir mídia iniciada pelo usuário, impeça que o dispositivo entre no modo ambiente.
• Verifique se todos os elementos da IU funcionam tanto com o botão direcional quanto com os controles de jogos. Consulte Navegação na TV e Gerenciar o hardware da TV.
• Altere a imagem de plano de fundo conforme os usuários navegam pelo conteúdo.
• Personalize a cor do plano de fundo para combinar com sua marca em fragmentos de Leanback.
• Confira se a interface não exige uma tela touchscreen. Consulte Tela de toque e Não é necessário declarar a tela de toque.
• Siga as diretrizes de propaganda eficaz.
• Para orientar o usuário em uma série de decisões, use a API de etapas guiadas da sua biblioteca Leanback.

Pesquisa e descoberta de conteúdo

Estes itens da lista de verificação se aplicam a jogos e apps.

• Forneça resultados da pesquisa do seu app na caixa de pesquisa geral da Android TV.
• Forneça campos de dados específicos da TV para pesquisa.
• Verifique se o app apresenta conteúdo descoberto em uma tela de detalhes que permite que o usuário comece a assistir o conteúdo imediatamente.

Tela inicial da TV

Estes itens da lista de verificação se aplicam ao layout e ao conteúdo da tela inicial.

Canais

• Forneça um nome significativo que represente o conteúdo do canal. Não use o nome do seu app como o nome de um canal.
• Não mude o nome do canal, a menos que haja alguma interação com o usuário.
• Inclua um ícone associado a cada canal. O ícone não precisa ser o mesmo do seu app. Ele pode ser uma representação do conteúdo do canal de acordo com a marca.
• Faça com que cada canal seja único e não imite a funcionalidade da linha "Novidades Play". Por exemplo, permitir que os usuários continuem assistindo de onde pararam em um vídeo não é um uso válido para um canal.

Conteúdo nos canais

• Limite cada programa em um canal a um único conteúdo. Um programa não pode conter uma coleção de vídeos.
• Não use programas para mensagens promocionais ou anúncios.
• Inclua uma descrição adequada para cada programa e mapeie os metadados corretamente. Por exemplo, a classificação do conteúdo não pode aparecer no lugar do título.
• Não corte nem estique as imagens de visualização que representam o conteúdo do programa. Elas precisam se encaixar em uma das proporções disponíveis.
• Comece a reproduzir um programa assim que o usuário o selecionar.

Novidades Play

• Não adicione conteúdo à linha "Novidades Play", a menos que o usuário esteja interagendo com ela de alguma forma. Por exemplo, você pode adicionar o próximo episódio de uma série que o usuário está assistindo no momento, mas não uma série relacionada, mas diferente, quando o usuário concluir a série atual.
• Limite o conteúdo de "Novidades Play" a programas de TV, filmes ou eventos tradicionais. Não adicione clipes à linha "Novidades Play".

Apps de reprodução

Estes itens da lista de verificação se aplicam a apps que executam a reprodução de mídia.

• Registrar uma sessão de mídia para informar à plataforma o estado de reprodução de mídia e permitir que os controles de reprodução sejam delegados ao app.
• Defina a flag FLAG_KEEP_SCREEN_ON enquanto o vídeo é reproduzido na tela para impedir que o dispositivo entre no modo de espera ou no modo ambiente durante a reprodução.
• Valide se os comandos de mídia expõem corretamente os metadados e controlam a reprodução usando Media Controller Test e o Media Session Validator.
• Cumpra as diretrizes de qualidade relacionadas ao modo ambiente. O modo ambiente mantém os usuários entretidos entre as sessões de uso e evita o burn-in da tela.
• Crie um perfil da memória do app e verifique ActivityManager.isLowRamDevice() para descobrir dispositivos com pouca RAM. Para esses dispositivos, você precisa seguir os requisitos nas diretrizes para otimizar o uso da memória.

Jogos

Estes itens da lista de verificação se aplicam a jogos.

• Defina a flag isGame no manifesto para que o jogo apareça na seção de jogos da tela inicial.
• Verifique se a compatibilidade com controles de jogos não depende dos botões "Iniciar", "Selecionar" ou "Menu". Nem todos os controles têm esses botões.
• Use um gráfico de gamepad genérico, sem uma marca específica de controles, para mostrar mapeamentos de botões de jogos.
• Verifique a conectividade de Ethernet e Wi-Fi.
• Ofereça aos usuários uma maneira clara de sair do seu app.

Distribuir para o Android TV

Para saber como distribuir para o Android TV, consulte o guia detalhado para publicar apps para TV no Google Play.