Qualidade do aplicativo para TV

Os usuários têm expectativas diferentes ao assistir TV em comparação com o uso de um smartphone ou tablet. Um usuário comum de TV fica a aproximadamente três metros de distância da tela, então os detalhes pequenos são menos observados e os textos pequenos são difíceis de ler. Como o usuário se senta longe da TV, ele precisa de um controle remoto para navegar e fazer seleções em vez de tocar em elementos na tela. Essas diferenças afetam significativamente os requisitos que fazem com que uma experiência do usuário de TV seja boa.

A primeira etapa para a criação de uma ótima experiência para usuários de TV é analisar e seguir as diretrizes de design para Android TV. Para entender os requisitos básicos de implementação de um app para TV, consulte também o treinamento Criar apps para TV.

Para saber mais sobre como publicar apps para TV no Google Play, consulte Distribuir para Android TV.

Projeto visual e interação do usuário

Os critérios a seguir ajudam a garantir que seu app siga os padrões essenciais de design e interação para que a experiência do usuário seja consistente, intuitiva e agradável em dispositivos de TV.

Tipo Teste Descrição
Tela de início TV-LM

O app exibe o ícone na tela de início no Android TV Launcher depois da instalação. Para mais informações, consulte Declarar uma atividade de TV.

TV-LB

O app exibe um banner completo de 320 x 180 pixels e pelo menos um ícone de app de 160 x 160 pixels (na densidade xhdpi) como ícones de inicialização no Android TV Launcher. Para mais informações, consulte as diretrizes de ícones e banners de apps do Android TV.

TV-BN

O banner inicializador contém o nome do aplicativo.

TV-LG

Se o app for um jogo, ele aparecerá na linha Jogos no Android TV Launcher.
Para mais informações, consulte Mostrar o jogo na tela inicial.

TV-LS

O app é executado sem erros, inclusive durante a instalação, o carregamento e o teste. Para mais informações, consulte Executar apps de TV.

Layout TV-LO

Todas as interfaces do app são apresentadas na orientação paisagem e sem efeito letterbox/pillarbox vertical. Apenas a cor preta pode ser usada nas barras dos vídeos no formato original. Para mais informações, consulte Criar layouts básicos para TV.

TV-OV

O app não exibe texto nem funcionalidade que estejam parcialmente cortados pelas margens da tela. Para mais informações, consulte Overscan.

TV-TR

O app não oculta parcialmente outros apps. Ele preenche toda a tela e tem um plano de fundo não transparente.

TV-DP

É possível navegar pelas funções do app com controles de botão direcional de cinco vias, a não ser que o app exija um controle de jogos, conforme especificado no critério TV-GP na seção "Controles" da tabela "Funcionalidade" abaixo. Para mais informações, consulte Navegação na TV.

TV-DK

Se o app exigir um controle de jogos, conforme especificado no critério TV-GP, será possível navegar por todas as funções dele usando as teclas padrão de controle de jogos do Android. Para mais informações, consulte Processar o pressionamento do botão do gamepad.

TV-DM

O app não depende de um controle remoto com um botão de menu para acessar os controles da interface do usuário.

TV-DB

Ao pressionar o botão "Voltar", você retorna à tela inicial do Android TV. Para mais informações, consulte Fornecer comportamento adequado do botão "Voltar".

TV-DL

Se o app tiver um feed de TV ao vivo integrado à guia "Ao vivo", ele vai atender aos requisitos simples de reprodução e retorno. Para mais informações, consulte Botão "Voltar".

TV-SB

Uma consulta de pesquisa dentro do app é exibida na caixa de pesquisa, de modo semelhante à interface do usuário disponibilizada pela classe SearchFragment, e os resultados são relevantes para a consulta. Para mais informações, consulte Pesquisar em apps de TV.

Funcionalidade e desempenho

Estes critérios garantem que seu app seja configurado corretamente e apresente o comportamento funcional esperado.

Tipo Teste Descrição
SDK TV-PS Além dos requisitos de desempenho e estabilidade principais, o app declara suporte a dispositivos Android TV usados com frequência definindo uma versão mínima do SDK do Android de 31 ou inferior ao definir o valor minSdkVersion.
Manifesto TV-ML

O manifesto do app define o tipo de intent de ACTION_MAIN com a categoria CATEGORY_LEANBACK_LAUNCHER. Para mais informações, consulte Declarar uma atividade de TV.

TV-MT

O manifesto do app define o recurso de hardware android.hardware.touchscreen e outros listados em "Declarar requisitos de hardware para TV" como não obrigatórios. Para mais informações, consulte Declarar requisitos de hardware para TV.

Controles de jogos TV-GP

Se o app usa um controle de jogos como método de entrada principal, ele declara o requisito adequado com a tag de manifesto <uses-feature>. Para mais informações, consulte Declarar compatibilidade para controles de jogos.

TV-GC

Se o app apresenta instruções visuais para o uso de controles de jogos, as instruções não podem conter marcas e precisam mostrar um layout de botão compatível. Para mais informações, consulte Lidar com controles para jogos.

Publicidade TV-AP

O app oferece interação com publicidade usando os controles do botão direcional. Para mais informações, consulte Ativar a navegação com D-pad.

TV-AD

Para publicidade em tela cheia e sem vídeo, o app permite que o usuário dispense imediatamente o anúncio com os controles do botão direcional ou do gamepad.

TV-AU

Para publicidade clicável, sem vídeo e que não é de tela cheia, o app não permite que os anúncios vinculem um URL da Web.

TV-AA

Para publicidade clicável, sem vídeo e que não é de tela cheia, o app não permite que os anúncios vinculem outro app não disponível em dispositivos de TV.

Conteúdo da Web TV-WB

Para conteúdo da Web, o app só pode usar componentes WebView. O app não pode tentar iniciar um app de navegador da Web.

Reprodução de mídia TV-NP

Se o app continuar reproduzindo áudio depois que o usuário retornar à tela inicial ou alternar para outro app, ele apresentará um card Tocando agora na linha de recomendações da tela inicial para que o usuário possa retornar ao app para controlar a reprodução. Para mais informações, consulte Exibir um card "Tocando agora".

Recomendamos que você pause o vídeo quando o usuário sair do app e não integre o vídeo ao card Tocando agora.

TV-PA

Se o app apresentar um card Tocando agora, a seleção desse card levará o usuário a uma tela que permite pausar a reprodução.

TV-PP

Se o app toca conteúdos de vídeo ou música, ele alterna entre as funções tocar e pausar mídia quando o evento da tecla correspondente é enviado durante a reprodução. Para mais informações, consulte KEYCODE_MEDIA_PLAY_PAUSE.

TV-PC

Durante a reprodução de um vídeo ou áudio, pressionar a parte central do botão direcional pausa a mídia. Quando a reprodução estiver pausada, pressione a parte central do botão direcional para retomar. As partes esquerda e direita do botão direcional avançam e retrocedem a faixa atual, respectivamente. Para mais informações, consulte Eventos de mídia.

TV-PN

Os itens são adicionados ao canal "Assistir a seguir" com base nas diretrizes do "Assistir a seguir" para desenvolvedores de apps.

Modo ambiente TV-BU

Quando há uma reprodução de vídeo ativa iniciada pelo usuário, o app impede que o dispositivo entre no modo ambiente. Para mais informações, consulte Modo ambiente.

TV-BY

Quando não há reprodução ou animação de vídeo ativa iniciada pelo usuário, o app não impede que o dispositivo entre no modo ambiente.

TV-BA

Para reprodução somente de áudio, o app não impede que o dispositivo entre no modo ambiente a menos que implemente uma experiência de imagens não estáticas, como videoclipes ou imagens, enquanto a música está sendo reproduzida.

Memória
TV-ME

Em dispositivos com pouca RAM (em que ActivityManager.isLowRamDevice() retorna "true"), o uso máximo de memória (Anon+Swap + Gráficos + Memória de arquivo) de um app em primeiro plano precisa permanecer dentro dos limites (incluindo mecanismos de medição e ressalvas específicos) definidos em Otimizar o uso de memória.

Google Play

Siga estes requisitos para configurar seu app de forma consistente com outras páginas "Detalhes do app" e classificações no Google Play:

Tipo Teste Descrição
Picture-in-picture TV-IC

O app define os metadados adequados para categorizar o uso do picture-in-picture em um dos tipos de uso permitidos. Ele também declara um título e um subtítulo que representam com precisão a finalidade do PIP.

Para mais informações, consulte Multitarefas na TV.

TV-IP

No modo picture-in-picture, o app não mostra material promocional ou publicidade que não seja inerente à fonte de conteúdo.

TV-IQ

No modo picture-in-picture, o app não prejudica a experiência de outra atividade em tela cheia.

O app não pode usar recursos em excesso, assumir o foco de áudio, interferir na MediaSession ativa ou solicitar um número desproporcional de sessões de decodificador.

TV-IH

O app não mostra controles de interface nem elementos navegáveis no modo picture-in-picture. Os apps podem expor determinados controles do usuário diretamente na janela picture-in-picture.

TV-IE

Para entrar no modo picture-in-picture, o usuário precisa realizar uma ação explícita e intencional no app. O app não entra automaticamente no modo PiP (setAutoEnterEnabled definido como false), a menos que o usuário esteja em uma chamada em andamento.

TV-IS

O app não pode mostrar nenhuma interface para entrar no PiP se o modo picture-in-picture estiver desativado em um dispositivo.

TV-IX

O app usa o modo picture-in-picture apenas para a continuação de uma atividade em andamento. A experiência picture-in-picture não incentiva nem encoraja os usuários a voltar para a visualização em tela cheia do app durante ou após a conclusão da atividade.

Políticas do Google Play TV-G1

O uso de Android App Bundles é obrigatório para todos os apps de TV novos e existentes na Google Play Store.

TV-G2

Seu app precisa obedecer aos requisitos da Central de políticas para desenvolvedores do Google Play.

Página de detalhes do app TV-G3

A funcionalidade do app corresponde ao esperado ou descrito na página "Detalhes do app" da Google Play Store.

TV-G4

O envio do app fez upload de pelo menos uma captura de tela de alta resolução e sem mudanças que mostre com precisão a versão atual da experiência do app de TV.

Credenciais de login TV-G5

Para apps com recursos pagos, você precisa fornecer credenciais de login no Google Play Console para testar a experiência completa do app. Para mais informações, consulte Acesso ao app em "Preparar o app para revisão".

Perguntas frequentes

Depois de enviar meu app, como saberei se ele não atende a todos os requisitos para dispositivos de TV?

Se o app não atender aos requisitos de usabilidade descritos nesta página, a equipe da Play Store entrará em contato pelo endereço de e-mail especificado na conta do Google Play Console associada ao app.

Atenção:o app precisa incluir as entradas do manifesto necessárias para dispositivos de TV. Caso contrário, ele não será considerado um app de TV e não será avaliado com relação aos requisitos de usabilidade desse tipo de dispositivo.

Meu app é destinado a outros formatos além da TV. Se não atender aos requisitos para dispositivos de TV, o app novo ou atualizado ainda vai aparecer no Google Play para outros dispositivos?

As atualizações na página "Detalhes do app" do Google Play só podem ser publicadas se todas as mudanças forem aprovadas. Se uma atualização de um artefato específico de um formato estiver bloqueando outras atualizações da sua página de detalhes para outros dispositivos, como smartphones ou tablets, talvez seja necessário remover esse artefato substituindo-o por um envio vazio até que você possa atender aos requisitos.

Se meu app atender aos requisitos de publicação, quando ele será disponibilizado na Google Play Store em dispositivos de TV?

Os apps que atendem aos requisitos para TV aparecerão imediatamente na Play Store nesses dispositivos.