Los dispositivos de TV requieren un dispositivo de hardware secundario para interactuar con apps, como un control remoto básico o un control de juegos. Por lo tanto, tu app debe admitir la entrada de mando de dirección (pad direccional). Además, es posible que tu app necesite controlar controles que se desconectan y entradas de más de un tipo de control.
En esta guía, se analizan los requisitos de control de controles para dispositivos de TV.
Controles mínimos para pad direccional
El control predeterminado para un dispositivo de TV es el pad direccional. En general, tu app debe poder operarse desde un control remoto que solo tenga los botones de arriba, abajo, izquierda, derecha, seleccionar, inicio y atrás. Si tu app es un juego que normalmente requiere un control de juego con controles adicionales, intenta admitir el juego solo con estos controles de pad direccional. De lo contrario, advierte al usuario que se necesita un control y permítele salir del juego sin problemas mediante el control de pad direccional.
Para obtener más información sobre la navegación con controles de pad direccional para dispositivos de TV, consulta Navegación en TV.
Administra la desconexión de controles
Los controles para TV, a menudo, son dispositivos Bluetooth que pueden intentar ahorrar energía al entrar en modo de suspensión y desconectarse del dispositivo de TV. Esto significa que una app puede interrumpirse o reiniciarse si no está configurada para admitir estos eventos de reconexión. Estos eventos pueden ocurrir en cualquiera de las siguientes circunstancias:
- Mientras se reproduce un video de varios minutos de duración, es posible que un pad direccional o un control de juegos entre en modo de suspensión, se desconecte de la TV y se vuelva a conectar más tarde.
- Durante un juego, es posible que un jugador nuevo se una a la partida con un control de juego que aún no esté conectado.
- Durante un juego, es posible que un jugador salga del juego y desconecte un control de juego.
Toda actividad de apps para TV que esté sujeta a eventos de conexión y desconexión debe configurarse para controlar los eventos de reconexión en el manifiesto de la app. En la siguiente muestra de código, se muestra cómo habilitar una actividad para controlar cambios de configuración, lo que incluye que un teclado o un dispositivo de navegación se conecte, desconecte o se vuelva a conectar:
<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>
Este cambio de configuración permite que la app continúe ejecutándose a través de un evento de reconexión, en lugar de reiniciarse por el framework de Android, lo que no brinda una buena experiencia del usuario.
Administra las variaciones de entrada de pad direccional
Es posible que los usuarios de dispositivos de TV tengan más de un tipo de control que usan con su TV. Por ejemplo, un usuario puede tener un control de pad direccional básico y un control de juegos. Los códigos clave que proporciona un control de juego cuando se utiliza para las funciones de un pad direccional pueden variar con respecto a los códigos de teclas enviados por un pad direccional básico.
Controla las variaciones en la entrada de pad direccional para que el usuario no tenga que cambiar de controlador y operar tu app. Si quieres obtener más información para manejar las variaciones de entrada, consulta Cómo procesar la entrada de mando de dirección.
Administra eventos de botones
Cuando el usuario hace clic en un botón de un control, tu app recibe un evento con un KeyEvent
. El comportamiento previsto del botón puede ser un evento multimedia, como reproducir, pausar o detener, o un evento de TV, como una selección o navegación. Para proporcionar una buena experiencia del usuario, asigna un comportamiento coherente a los botones del control.
Eventos de IU de TV
Asigna el comportamiento de la IU de TV a los botones que generan tipos de KeyEvent
, como se muestra en la siguiente tabla:
KeyEvent | Comportamiento |
---|---|
KEYCODE_BUTTON_B , KEYCODE_BACK | Atrás |
KEYCODE_BUTTON_SELECT , KEYCODE_BUTTON_A , KEYCODE_ENTER ,
KEYCODE_DPAD_CENTER y KEYCODE_NUMPAD_ENTER | Selección |
KEYCODE_DPAD_UP , KEYCODE_DPAD_DOWN , KEYCODE_DPAD_LEFT y KEYCODE_DPAD_RIGHT | Navegación |
Eventos multimedia
Cuando el usuario esté mirando contenido multimedia, asigna el comportamiento a los botones que generan tipos de KeyEvent
, como se muestra en la siguiente tabla. Si tu app controla una MediaSession
, usa un MediaControllerAdapter
para llamar a uno de los métodos MediaControllerCompat.TransportControls
que se muestran en la tabla. Ten en cuenta que los botones de selección actúan como botones de reproducción o de pausa en este contexto.
KeyEvent | Llamada de TransportControls | Comportamiento |
---|---|---|
BUTTON_SELECT , BUTTON_A , ENTER ,
DPAD_CENTER y KEYCODE_NUMPAD_ENTER |
play() | Reproducir |
BUTTON_START , BUTTON_SELECT , BUTTON_A ,
ENTER , DPAD_CENTER y KEYCODE_NUMPAD_ENTER |
pause() | Pausar |
BUTTON_R1 | skipToNext() | Siguiente |
BUTTON_L1 | skipToPrevious() | Anterior |
DPAD_RIGHT , BUTTON_R2 , AXIS_RTRIGGER y AXIS_THROTTLE | fastForward() | Cinta que adelanta |
DPAD_LEFT , BUTTON_L2 , AXIS_LTRIGGER y AXIS_BRAKE | rewind() | Retroceder |
N/A | stop() | Detener |
Nota: Cuando uses un MediaSession
, no anules el control de botones específicos de contenido multimedia, como KEYCODE_MEDIA_PLAY
o KEYCODE_MEDIA_PAUSE
.
El sistema activa automáticamente el método MediaSession.Callback
adecuado.
Proporciona el comportamiento adecuado del botón Atrás
El botón Atrás nunca debe funcionar como un botón de activación. Por ejemplo, no lo uses para abrir y cerrar un menú. Úsalo solo para navegar hacia atrás, con estilo de ruta de navegación, por las pantallas anteriores en las que estuvo el reproductor.
Dado que el botón Atrás solo realiza una navegación lineal hacia atrás, puedes usarlo para dejar un menú dentro de la app abierto con un botón diferente y volver a la app. Al presionar el botón Atrás de forma consecutiva, siempre debe llegar a la pantalla principal de Android TV. Por ejemplo: juego > pantalla de pausa del juego > pantalla principal del juego > pantalla principal de Android TV o reproducción de programa de TV > pantalla principal de la app para TV > pantalla principal de Android TV.
Para obtener más información sobre el diseño para la navegación, consulta Cómo diseñar la navegación hacia atrás y hacia arriba. Para obtener información sobre la implementación, consulta Cómo proporcionar una navegación hacia atrás adecuada.
Administración de controles para juegos
Admite controles de pad direccional
Planifica tu esquema de control en torno a un pad direccional, ya que este es el conjunto predeterminado de los dispositivos Android TV. El jugador debe poder usar un pad direccional para todos los aspectos del juego, no solo para controlar el juego principal, sino también para navegar por los menús y los anuncios. Por ese motivo, asegúrate de que el juego para Android TV no haga referencia a una interfaz táctil con un idioma como "Presiona aquí para continuar".
La manera en que diseñas la interacción del jugador con el control puede ser clave para lograr una excelente experiencia del usuario. Analiza las siguientes prácticas recomendadas:
- Comunica los requisitos de los controles de antemano:Usa la descripción de Google Play para comunicar al jugador las expectativas de los controles. Deja en claro si un juego se adapta mejor a un control de juegos con un joystick que a uno con solo pad direccional. Un jugador que usa un control inadecuado para un juego podría tener una mala experiencia y darle una mala calificación al juego.
- Usa la asignación de botones coherente: La asignación intuitiva de botones es clave para una buena experiencia del usuario. Por ejemplo, adhiere a las costumbres aceptadas; para ello, usa el botón A para aceptar y el botón B para cancelar. También puedes ofrecer flexibilidad en forma de reasignación. Para obtener más información sobre la asignación de botones, consulta Cómo administrar las acciones del control.
- Detecta las capacidades del control y ajústalas según corresponda: Consulta al control sobre sus capacidades para optimizar la coincidencia entre el control y el juego. Por ejemplo, es posible que quieras que un jugador dirija un objeto moviendo el control en el aire, pero si el control del jugador no tiene hardware de acelerómetro ni giroscopio, la acción de mover no funciona. Consulta el control y, si la detección de movimiento no es compatible, cambia a un esquema de control alternativo disponible. Para obtener más información sobre cómo consultar las capacidades del control, consulta Compatibilidad de controles en diferentes versiones de Android.
Usa los botones correctos
No todos los controles de juego tienen los botones Inicio, Búsqueda o Menú. Asegúrate de que tu IU no dependa del uso de estos botones.
Administra varios controles
Cuando varios jugadores participan de un juego, cada uno con su propio control, es importante asignar cada par jugador-control. Para obtener información sobre cómo implementar la identificación control-número, consulta
getControllerNumber()
.
Administra la desconexión de controles
Cuando un control se desconecte en medio de un juego, pausa el juego y muestra un diálogo en el que se le solicite al jugador desconectado que vuelva a conectar el control.
Además, ofrece sugerencias para solucionar problemas en el diálogo. Por ejemplo, dile al jugador "Verifica tu conexión Bluetooth". Para obtener más información sobre la implementación de compatibilidad con dispositivos de entrada, consulta Cómo administrar las acciones de los controles y la Descripción general de Bluetooth.
Muestra instrucciones del control
Si tu juego proporciona instrucciones de control del juego visuales, usa una imagen de control que no contenga marcas y solo incluye botones compatibles con Android.
Para ver imágenes de ejemplo de un control compatible con Android, descarga la plantilla para control de juegos de Android TV (ZIP). Incluye un controlador blanco sobre un fondo negro y un controlador negro sobre un fondo blanco, que se muestra en la figura 1, como archivo PNG y de Adobe® Illustrator®.
![](https://developer.android.com/static/images/games/game-controller-buttons_2x.png?authuser=5&hl=es)
Figura 1: Ejemplo de instrucciones del control con la plantilla de control de juegos de Android TV