Cómo administrar controles de TV

Los dispositivos de TV necesitan un dispositivo de hardware secundario para interactuar con apps, ya sean simples controles remotos o controles de juego. Esto significa que tu aplicación debe ser compatible con la entrada de pad direccional. También significa que tu app puede necesitar manejar controles sin conexión y entradas de más de un tipo de control.

En esta lección, se detallan los requisitos de administración 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 debería 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, debería intentar permitir jugar con estos controles del pad direccional. Además, en este caso, tu app debería advertir al usuario sobre la necesidad de un control y permitir que salga sin conflicto de tu juego usando el control de pad direccional. Puedes obtener más información acerca de cómo manejar la navegación con el control de pad direccional para dispositivos de TV en Cómo desarrollar la navegación para 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 se configura para admitir estos eventos de reconexión. Estos eventos pueden ocurrir en cualquiera de las siguientes circunstancias:

  • Mientras se ve un video de varios minutos de duración, un pad direccional o control de juego entra en modo de suspensión, se desconecta del dispositivo de TV y luego se reconecta.
  • Durante un juego, un jugador se une a la partida usando un control de juego que no está conectado en ese momento.
  • Durante un juego, un jugador abandona la partida y desconecta un control de juego.

Toda actividad de app para TV que esté sujeta a eventos de conexión y desconexión debe configurarse para manejar eventos de reconexión en el manifiesto de la app. En el siguiente código de ejemplo, se muestra cómo habilitar una actividad para que maneje cambios de configuración, incluida la conexión, desconexión y reconexión de un teclado o un dispositivo de navegación:

    <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 vez de reiniciarse por el marco de trabajo de Android, lo que no supone una buena experiencia de usuario.

Administra las variaciones de entrada de pad direccional

Los usuarios de dispositivos de TV cuentan con más de un tipo de control que usan con su TV. Por ejemplo, un usuario podría tener un control de pad direccional básico y un control de juego. Los códigos clave que envía un control de juego cuando se utiliza para las funciones de un pad direccional pueden variar con respecto a los códigos clave enviados por un pad direccional físico.

Tu app debería manejar las variaciones de entrada de un pad direccional con respecto a un control de juego, de manera que el usuario no tenga que cambiar físicamente de control para usar tu app. Para obtener más información sobre cómo manejar estas variaciones de entrada, consulta Cómo manejar las acciones del control.

Administra eventos de botones

Cuando un usuario hace clic en un botón del control, tu app recibe un evento con un KeyEvent. El comportamiento pretendido para el botón puede ser un evento multimedia (como reproducir, pausar o detener contenido) o de TV (de selección o navegación). Para proporcionar una buena experiencia del usuario, tu app debería asignar un comportamiento consistente a los botones del control.

Eventos de IU de TV

Los botones que generan estos KeyEvents deberían ser manejados por la app de acuerdo con la siguiente tabla.

KeyEventComportamiento
BUTTON_B, BACKAtrás
BUTTON_SELECT, BUTTON_A, ENTER, DPAD_CENTER, KEYCODE_NUMPAD_ENTERSelección
DPAD_UP, DPAD_DOWN, DPAD_LEFT, DPAD_RIGHTNavegación

Eventos multimedia

Cuando el usuario mira contenido multimedia, tu app debería controlar los botones que generan esos KeyEvents según la tabla que aparece a continuación. Si tu app controla un elemento MediaSession, debería usar un elemento MediaControllerAdapter para llamar a uno de los métodos MediaControllerCompat.TransportControls como se muestra a continuación. Ten en cuenta que los botones de selección actúan como botones de reproducción/pausa en este contexto.

KeyEventLlamada de TransportControlsComportamiento
BUTTON_SELECT, BUTTON_A, ENTER, DPAD_CENTER, KEYCODE_NUMPAD_ENTERpause()Reproducir
BUTTON_START, BUTTON_SELECT, BUTTON_A, ENTER, DPAD_CENTER, KEYCODE_NUMPAD_ENTERpause()Pausar
BUTTON_R1skipToNext()Siguiente
BUTTON_L1skipToPrevious()Anterior
DPAD_RIGHT, BUTTON_R2, AXIS_RTRIGGER, AXIS_THROTTLEfastForward()Avanzar
DPAD_LEFT, BUTTON_L2, AXIS_LTRIGGER, AXIS_BRAKErewind()Retroceder
(No hay un KeyEvent asociado con la detención)stop()Detener

Administración de controles para juegos

Admite controles de pad direccional

Planifica tu esquema de control de un mando de dirección (pad direccional), ya que su configuración es la predeterminada para dispositivos Android TV. El jugador tiene que poder usar un pad direccional en todo momento, no solo para controlar el juego real, sino también para navegar por los menúes y los anuncios. Por lo tanto, el juego para Android TV no debería referirse específicamente a una interfaz táctil. Por ejemplo, las instrucciones de un juego para Android TV no deberían decirle al jugador "Presiona aquí para continuar".

La manera en que diseñas la interacción del jugador con el control puede ser clave para lograr una gran experiencia del usuario:

  • Comunica los requisitos del control de manera directa. Usa tu descripción de Google Play para comunicar al jugador las expectativas de los controles. Deja en claro si el juego resulta mejor para un control de juegos con joystick que para un pad direccional. Es problable que un jugador que use un control inadecuado tenga una experiencia de baja calidad y penalice tu juego en la calificación.
  • Usa una asignación de botones consistente. La asignación de botones intuitiva y flexible es clave para brindar una buena experiencia del usuario. Por ejemplo, deberías adherirte a las costumbres aceptadas y usar el botón A para Aceptar y 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 manejar las acciones del control.
  • Detecta las funciones del control y ajústalas en consecuencia. Averigua las funciones del control a fin de optimizar la coincidencia entre el control y el juego. Por ejemplo, tal vez quieras que un jugador dirija un objeto moviendo el control en el aire. Si el control del jugador no tiene acelerómetro y giroscopio, esa acción no funcionará. Por lo tanto, tu juego debería averiguar la función del control y, si no es compatible con la detección de movimiento, cambiar a otra alternativa disponible en el esquema del control. Para obtener información sobre cómo averiguar las funciones del control, consulta Compatibilidad de controles en diferentes versiones de Android.

Proporciona el comportamiento adecuado del botón Atrás

El botón atrás nunca debe cambiar de función. Por ejemplo, no debes usarlo para abrir y cerrar un menú. Solo debería navegar hacia atrás, siguiendo la ruta de navegación hacia las pantallas anteriores en las que estuvo el jugador, por ejemplo: Juego > Pantalla de juego en pausa > Pantalla principal del juego > Pantalla principal de Android.

Debido a que el botón Atrás solo debería realizar una navegación lineal (hacia atrás), puedes usarlo para dejar un menú dentro del juego (que se abre con un botón diferente) y para volver al juego. Para obtener información sobre el diseño para la navegación, consulta Navegación con los botones atrás y arriba. Para obtener información sobre la implementación, consulta Proporciona una navegación hacia atrás adecuada.

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 esos botones.

Administra varios controles

Cuando varios jugadores participan de un juego y cada uno usa su control, es importante mapear 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 desconecta en medio de un juego, el juego debería pausarse y debería aparecer un diálogo que solicite la jugador desconectado que vuelva a conectar el control.

El diálogo también debería ofrecer sugerencias de solución de problemas (por ejemplo, un diálogo emergente que diga al jugador "Revisa tu conexión Bluetooth"). Para obtener más información sobre la implementación de compatibilidad con dispositivos de entrada, consulta Administra las acciones del control. Puedes encontrar información específica sobre Bluetooth aquí.

Muestra instrucciones del control

Si tu juego proporciona instrucciones de control del juego visuales, la imagen del control no debería tener recursos de marca y debería solo incluir 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 archivo PNG y uno de Adobe® Illustrator® con un control blanco sobre un fondo negro y un control negro sobre fondo blanco (que se muestra en la figura 1).

Figura 1: Ejemplo de instrucciones del control con la Plantilla para control de juegos de Android TV (ZIP)