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 essas ideias em mente, você pode criar um app que se enquadre bem no Android TV e tenha o desempenho esperado pelos usuários.

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

Para ver os critérios que qualificam um app para Android TV para distribuição no Google Play, consulte Qualidade do app para TV.

Suporte a formatos 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.
• Verifique se o app precisa impedir que o dispositivo entre no Modo ambiente. Isso é especialmente relevante para apps de reprodução de mídia.
• Não declare um requisito para hardware que possa não ser compatível.
• Confirme que suas permissões não implicam requisitos de hardware.

Design da interface do usuário

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

• Para especificar atividades na orientação paisagem, defina 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 ativamente a reprodução de mídia iniciada pelo usuário, evite 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.
• Certifique-se de que sua interface não exija uma tela sensível ao toque. Consulte Touchscreen 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.
• Confira se o app apresenta conteúdo descoberto em uma tela de detalhes que permite ao usuário começar 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 app como nome de 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 exatamente o do app. Ele pode ser uma representação da marca do conteúdo no canal.
• Crie cada canal único e não imite a funcionalidade da linha Assistir em seguida. 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

• Limitar cada programa de 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 dele corretamente. Por exemplo, a classificação do conteúdo não pode aparecer onde o título é esperado.
• Não corte ou estique as imagens de visualização que representam o conteúdo do programa. Elas precisam se encaixar em uma das proporções disponíveis.
• Começa a jogar um programa assim que o usuário o seleciona.

Novidades Play

• Não adicione conteúdo à linha "Assistir em seguida", a menos que o usuário esteja interagindo 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, mas não uma série relacionada, mas diferente, quando o usuário termina a série atual.
• Limite o conteúdo do Assistir em seguida a programas de TV, filmes ou eventos tradicionais. Não adicione clipes à linha Assistir em seguida.

Apps de reprodução

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

• Registre uma sessão de mídia para informar a plataforma sobre o estado de reprodução de mídia e permitir que os controles de mídia sejam delegados ao app.
• Defina a flag FLAG_KEEP_SCREEN_ON enquanto o vídeo estiver sendo 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 com precisão os metadados e controlam a reprodução usando o teste do controle de mídia e o Media Session Validator.
• Siga as diretrizes de qualidade relacionadas ao modo ambiente. Esse modo mantém os usuários entretidos silenciosamente entre as sessões de exibição e evita o burn-in da tela.

Jogos

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

• Defina a sinalização isGame no manifesto para que seu jogo apareça na seção de jogos da tela inicial.
• Verifique se o suporte ao controle 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 controle, para mostrar os 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 no Android TV, consulte o guia detalhado para a publicação de apps para TV no Google Play.