Qualidade do aplicativo para TV

Os usuários têm expectativas diferentes ao assistir TV e ao usar 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 criar uma ótima experiência para os usuários da TV é analisar e seguir as Diretrizes de design do Android TV. Para entender os requisitos fundamentais de implementação de um app para TV, consulte também o treinamento Criar apps para TV.

Importante:para ajudar a garantir uma ótima experiência do usuário, os apps para dispositivos de TV precisam atender a requisitos específicos de usabilidade. Somente os apps que atendem aos critérios de qualidade nesta página se qualificam como apps para Android TV no Google Play.

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 saber mais, consulte Declarar uma atividade de TV.

TV-LB

O app mostra um banner de tamanho original de 320 x 180 pixels e um ícone de pelo menos 160 x 160 pixels (na densidade xhdpi) como ícones na tela de início no Android TV Launcher. Para mais informações, consulte Diretrizes para banners e ícones do app 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 seu jogo na tela inicial.

TV-LS

O app é executado com êxito e sem mensagens de erro, inclusive durante a instalação, o carregamento e os testes. Para saber mais, consulte Executar apps para TV.

Layout TV-LO

Todas as interfaces do app são apresentadas na orientação paisagem e sem efeito letterbox/pillarboxing vertical. Somente a cor preta pode ser usada em barras em vídeos no formato original. Para saber mais, 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 direções, a menos que o app exija um controle de jogo, conforme especificado no critério TV-GP na seção "Controles" da tabela "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, toda funcionalidade será navegável usando as teclas padrão do controle de jogos Android. Para saber mais, consulte Processar o pressionamento do botão do gamepad.

TV-DM

O app não depende de um dispositivo de controle remoto que tenha 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 saber mais, consulte Oferecer o 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 o botão "Voltar".

TV-SB

Uma consulta de pesquisa no app aparece na caixa de pesquisa de maneira semelhante à interface do usuário fornecida pelo SearchFragment, e os resultados são relevantes para essa consulta. Para saber mais, consulte Pesquisar em apps de TV.

Funcionalidade

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 saber mais, 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 saber mais, 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 saber mais, consulte Declarar suporte a controles de jogos.

TV-GC

Se o app fornece instruções visuais para o uso de controles de jogos, as instruções não contêm marcas e mostram um layout de botão compatível. Para saber mais, consulte Gerenciar controles para jogos.

Publicidade TV-AP

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

TV-AD

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

TV-AU

Para publicidade sem vídeo, em tela cheia e com recurso de clique, o app não permite que os anúncios vinculem um URL da Web.

TV-AA

Para publicidade clicável, sem vídeo e sem tela cheia, o app não permite que os anúncios vinculem outro app que não está 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 som ou vídeo depois que o usuário retornar à tela inicial ou alternar para outro app, ele apresentará um card Tocando agora na linha de recomendação da tela inicial para que os usuários possam retornar ao app para controlar a reprodução. Para mais informações, consulte Exibir um card "Tocando agora".

TV-PA

Se o app fornecer 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 reproduzir conteúdo de vídeo ou música, ele alternará entre reproduzir e pausar a reprodução de mídia quando um evento da tecla de reprodução ou pausa for enviado durante a reprodução. Para mais informações, consulte KEYCODE_MEDIA_PLAY_PAUSE.

TV-PC

Enquanto um vídeo ou áudio estiver sendo reproduzido, pressionar o botão central do botão direcional pausa a mídia que está sendo reproduzida. Quando a reprodução for pausada, o pressionamento do botão central retoma a reprodução. Os botões direcional esquerdo e direito 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 canal "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 vídeos de música ou imagens, enquanto a música estiver tocando.

Google Play

Siga estes requisitos para configurar o app de maneira consistente com outras páginas de detalhes e classificações no Google Play:

Tipo teste Descrição
Políticas do Google Play TV-G1

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

TV-G2

Seu app precisa seguir os 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 inalterada e de alta resolução que mostre com precisão a versão atual da experiência do seu app de TV.

Credenciais de login TV-G5

No caso de 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 de apps 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.

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 para TV e não será avaliado com relação aos requisitos de usabilidade dessa tecnologia.

Meu app é destinado a formatos que não são apenas dispositivos de TV. Se não atender aos requisitos para dispositivos de TV, o app novo ou atualizado ainda aparecerá no Google Play para outros dispositivos?

Só será possível publicar atualizações na página "Detalhes do app" do Google Play se todas as mudanças forem aprovadas. Se uma atualização de um artefato específico de formato estiver bloqueando outras atualizações da página de detalhes 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.