Dispositivos de TV exigem um dispositivo de hardware secundário para interagir com apps: um controle remoto básico ou controle de jogo. Portanto, seu app precisa oferecer suporte à entrada por botão direcional. Além disso, seu app pode precisar processar controladores off-line e entrada de mais de um tipo de controlador.
Este guia discute os requisitos para lidar com controladores para dispositivos de TV.
Controles D-pad mínimos
O controlador padrão para um dispositivo de TV é um D-pad. Em geral, o app precisa ser operado em um controle remoto que tenha apenas os botões para cima, para baixo, para a esquerda, para a direita, selecionar, voltar e início. Se o app for um jogo que normalmente exige um controle com outros controles, tente oferecer suporte ao jogo usando apenas esses controles D-pad. Caso contrário, avise ao usuário que um controle é necessário e permita que ele saia do jogo normalmente usando o controle D-pad.
Para saber mais sobre como processar a navegação com o controlador D-pad para dispositivos de TV, consulte Navegação na TV.
Tratar desconexões do controlador
Controladores para TV costumam ser dispositivos Bluetooth, que podem tentar economizar energia entrando periodicamente no modo de espera e desconectando o dispositivo de TV. Isso significa que um app poderá ser interrompido ou reiniciado se não estiver configurado para processar esses eventos de reconexão. Esses eventos podem acontecer em qualquer uma das seguintes circunstâncias:
- Durante um vídeo com vários minutos de duração, um D-pad ou controlador de jogo pode entrar no modo de suspensão, desconectar do dispositivo de TV e reconectar mais tarde.
- Durante o jogo, um novo jogador pode usar um controle que ainda não esteja conectado.
- Durante o jogo, um jogador pode sair e desconectar um controle.
Qualquer atividade de app de TV sujeita a eventos de desconexão e reconexão precisa ser configurada para processar eventos de reconexão no manifesto do app. O exemplo de código a seguir demonstra como permitir que uma atividade processe mudanças de configuração, incluindo um teclado ou dispositivo de navegação conectado, desconectado ou reconectado:
<activity
android:name="com.example.android.TvActivity"
android:label="@string/app_name"
android:configChanges="keyboard|keyboardHidden|navigation"
android:theme="@style/Theme.Leanback">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LEANBACK_LAUNCHER" />
</intent-filter>
...
</activity>
Essa mudança de configuração permite que o app continue sendo executado após um evento de reconexão, em vez de ser reiniciado pelo framework do Android, o que não é uma boa experiência do usuário.
Gerenciar variações de entradas do D-pad
Os usuários de dispositivos de TV podem ter mais de um tipo de controle para usar com a TV. Por exemplo, um usuário pode ter um controle D-pad básico e um controle de jogo. Os códigos de tecla fornecidos por um controle de jogo quando está sendo usado para funções do botão direcional podem ser diferentes dos códigos enviados por um botão direcional básico.
Gerencie as variações na entrada do botão direcional para que o usuário não precise alternar entre os controles para operar o app. Para saber mais sobre como lidar com variações de entrada, consulte Processar entradas do botão direcional.
Gerenciar eventos de botão
Quando o usuário clica em um botão em um controlador, seu app recebe um evento com um
KeyEvent. O comportamento
esperado para o botão pode ser um evento de mídia, como tocar, pausar ou parar, ou pode ser um evento do tipo TV, como
seleção ou navegação. Para oferecer uma boa experiência do usuário, atribua um comportamento
consistente aos botões de controle.
Eventos de IU da TV
Atribua o comportamento da interface da TV aos botões que geram tipos KeyEvent,
conforme mostrado na tabela abaixo:
KeyEvent | Comportamento |
|---|---|
KEYCODE_BUTTON_B, KEYCODE_BACK | Voltar |
KEYCODE_BUTTON_SELECT, KEYCODE_BUTTON_A, KEYCODE_ENTER, KEYCODE_DPAD_CENTER e KEYCODE_NUMPAD_ENTER | Seleção |
KEYCODE_DPAD_UP, KEYCODE_DPAD_DOWN, KEYCODE_DPAD_LEFT e KEYCODE_DPAD_RIGHT | Navegação |
Eventos de mídia
Quando o usuário estiver assistindo mídia, atribua um comportamento aos botões que geram
tipos de KeyEvent, conforme mostrado na tabela abaixo. Caso seu app esteja controlando um
MediaSession,
use um MediaControllerAdapter
para chamar um dos métodos MediaControllerCompat.TransportControls
mostrados na tabela. Os botões de seleção funcionam como botões de reprodução ou pausa
nesse contexto.
KeyEvent | Chamada TransportControls | Comportamento |
|---|---|---|
BUTTON_SELECT, BUTTON_A, ENTER, DPAD_CENTER e KEYCODE_NUMPAD_ENTER |
play() | Reproduzir |
BUTTON_START, BUTTON_SELECT, BUTTON_A, ENTER, DPAD_CENTER e KEYCODE_NUMPAD_ENTER |
pause() | Pausar |
BUTTON_R1 | skipToNext() | Pular para o próximo |
BUTTON_L1 | skipToPrevious() | Pular para a anterior |
DPAD_RIGHT, BUTTON_R2, AXIS_RTRIGGER e AXIS_THROTTLE | fastForward() | Avançar |
DPAD_LEFT, BUTTON_L2, AXIS_LTRIGGER e AXIS_BRAKE | rewind() | Voltar |
| N/A | stop() | Parar |
Observação:ao usar uma MediaSession, não modifique o processamento de
botões específicos de mídia, como
KEYCODE_MEDIA_PLAY
ou KEYCODE_MEDIA_PAUSE.
O sistema aciona automaticamente o método MediaSession.Callback apropriado.
Fornecer o comportamento adequado do botão "Voltar"
O botão "Voltar" nunca deve funcionar como um botão de alternância. Por exemplo, não a use para abrir e fechar um menu ao mesmo tempo. Use essa opção somente para navegar para trás, no estilo de navegação estrutural, pelas telas anteriores em que o player esteve.
Como o botão "Voltar" executa apenas a navegação linear e para trás, você pode usá-lo para deixar um menu no app aberto por um botão diferente e retornar ao app. O pressionamento consecutivo do botão "Voltar" sempre leva à tela inicial do Android TV. Por exemplo: jogo > tela de pausa do jogo > tela principal do jogo > tela inicial do Android TV ou exibição de programa de TV > tela principal do app para TV > tela inicial do Android TV.
Para mais informações sobre o design para navegação, consulte Como projetar a navegação de retorno e para cima. Para saber mais sobre a implementação, consulte Como fornecer uma navegação de retorno adequada.
Gerenciar controladores para jogos
Compatibilidade com controles D-pad
Planeje seu esquema de controle com base em um controle direcional, já que esse conjunto é o padrão para dispositivos Android TV. O jogador precisa ser capaz de usar um botão direcional para todos os aspectos do jogo, não apenas para controlar a jogabilidade principal, mas também para navegar por menus e anúncios. Por esse motivo, confira se o jogo para Android TV não se refere a uma interface de toque com linguagem como "Toque aqui para continuar".
A forma como você molda a interação do jogador com o controle pode ser fundamental para proporcionar uma ótima experiência do usuário. Considere as seguintes práticas recomendadas:
- Comunique os requisitos do controlador com antecedência:use sua descrição do Google Play para comunicar ao jogador qualquer expectativa sobre os controles. Se um jogo é mais adequado para um gamepad com joystick do que para um que tenha apenas um botão direcional, deixe isso claro. Um jogador que usa um controle inadequado para um jogo pode ter uma experiência ruim e dar uma classificação ruim ao seu jogo.
- Use um mapeamento de botões consistente:o mapeamento intuitivo é fundamental para uma boa experiência do usuário. Por exemplo, respeite os personalizados aceitos usando o botão A para aceitar e o botão B para cancelar. Você também pode oferecer flexibilidade na forma de remapeamento. Para mais informações sobre o mapeamento de botões, consulte Gerenciar ações do controlador.
- Detecte os recursos do controle e faça os ajustes necessários:consulte o controle sobre os recursos dele para otimizar a correspondência entre o controle e o jogo. Por exemplo, talvez você queira que um jogador direcione um objeto balançando o controle no ar, mas se o controle dele não tiver o hardware do acelerômetro e do giroscópio, a ondulação não funcionará. Consulte o controlador e, se a detecção de movimento não for compatível, mude para um esquema de controle alternativo disponível. Para mais informações sobre como consultar os recursos de controladores, consulte Suporte a controladores em todas as versões do Android.
Usar os botões apropriados
Nem todos os controladores de jogos oferecem os botões "Iniciar", "Pesquisar" ou "Menu". Garanta que a IU não dependa do uso desses botões.
Gerenciar vários controles
Quando vários jogadores estão jogando, cada um com o próprio controle, é importante mapear cada par jogador-controlador. Para informações sobre como implementar a identificação de número de controlador, consulte
getControllerNumber().
Tratar desconexões do controlador
Quando um controle for desconectado no meio do jogo, pause o jogo e mostre uma caixa de diálogo solicitando que o jogador desconectado reconecte o controle.
Além disso, ofereça dicas de solução de problemas na caixa de diálogo. Por exemplo, diga ao player para "Verificar a conexão Bluetooth". Para ver mais informações sobre como implementar o suporte a dispositivos de entrada, consulte Gerenciar ações do controle e a Visão geral de Bluetooth.
Mostrar instruções de controladores
Se o jogo oferece instruções visuais de controle, use uma imagem do controlador sem marcas e inclua apenas botões compatíveis com Android.
Para conferir exemplos de imagens de um controle compatível com Android, faça o download do Modelo de gamepad para Android TV (ZIP). Ele inclui um controle branco sobre um fundo preto e um controle preto sobre um fundo branco, mostrado na Figura 1, como um arquivo PNG e como um arquivo do Adobe® Illustrator®.
Figura 1. Exemplos de instruções de controle usando o modelo de gamepad do Android TV.