Qualidade do aplicativo para TV

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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.

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.

O banner inicializador contém o nome do aplicativo.

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.

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.

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.

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

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

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.

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.

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.

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".

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".

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

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

Seu app precisa seguir os requisitos da Central de políticas do desenvolvedor do Google Play.

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

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.

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".