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 de TV, consulte também o treinamento Criar apps para TV.

Para saber mais sobre como publicar seus 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 de interação e design essenciais para uma experiência do usuário 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 (com densidade xhdpi) como ícones na tela de início no Android TV Launcher. Para mais informações, consulte as diretrizes de banner e ícone do app para 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 mensagens de erro, incluindo 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. Só é possível usar a cor preta para as barras em vídeos no formato original. Para mais informações, consulte Criar layouts básicos de 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

A funcionalidade do app é navegável 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 "Controladores" da tabela de funcionalidade a seguir. 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 do controle de jogos Android. Para mais informações, consulte Processar o pressionamento do botão do gamepad.

TV-DM

O app não depende de um dispositivo de controle remoto com um botão 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 atende 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
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 suporte 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 Processar controles de jogos.

Publicidade TV-AP

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

TV-AD

Para publicidade sem vídeo em tela cheia, o app permite que o usuário dispense imediatamente anúncios com controles de botão direcional ou 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 pode não tentar iniciar um app de navegador da Web.

Reprodução de mídia TV-NP

Se o app continuar a reproduzir áudio depois que o usuário retornar à tela inicial ou alternar para outro app, ele vai 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 Mostrar um card do Tocando agora.

Recomendamos que você pause o vídeo quando o usuário sair do app e não integre o vídeo com o card Agora em reprodução.

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 a mídia quando o evento da tecla correspondente é enviado durante a reprodução. Confira mais informações em 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 a reprodução. Os botões esquerdo e direito 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

Para dispositivos com pouca RAM (em que ActivityManager.isLowRamDevice() retorna "true"), o uso máximo de memória ( Anon+Swap + Graphics + File Memory) 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 o app de forma consistente com outras listagens 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 para que esse PIP está sendo usado.

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

TV-IP

Enquanto estiver em tela dividida, o app não mostra material promocional ou publicidade que não seja inerentemente parte da fonte de conteúdo.

TV-IQ

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

O app não pode usar recursos excessivos, 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 IU ou elementos navegáveis no modo picture-in-picture. Os apps podem expor determinados controles do usuário diretamente na janela do picture-in-picture.

TV-IE

A entrada no modo picture-in-picture requer uma ação explícita e intencional do usuário no app. O app não entra automaticamente no 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 de imagem em imagem não incentiva os usuários a retornar à visualização em tela cheia do app durante a atividade ou depois que ela for concluída.

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 seguir os requisitos da Central de políticas do desenvolvedor do Google Play.

Página de detalhes do app TV-G3

A funcionalidade do app funciona como esperado ou conforme descrito na página "Detalhes do app" da Google Play Store.

TV-G4

O envio do app fez o upload de pelo menos uma captura de tela de alta resolução e sem alterações 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, é necessário 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 seu 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 vai entrar em contato pelo endereço de e-mail especificado na conta do Google Play Console associada ao app.

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

Meu app é destinado a outros formatos além de dispositivos de TV. Se o app 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 da página "Detalhes do app" no Google Play só podem ser publicadas se todas as mudanças forem aprovadas. Se uma atualização de um artefato específico de formato estiver bloqueando outras atualizações da sua listagem para outros dispositivos, como smartphones ou tablets, remova 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.