Android TV

Navegación con el pad direccional en Android TV

El control remoto de Android TV tiene un pad direccional que envía comandos que llegan como eventos de tecla a dispatchKeyEvent(KeyEvent) de tu Activity. Estos permisos deben delegarse en el PlayerView:

Kotlin

override fun dispatchKeyEvent(event: KeyEvent?): Boolean {
  return playerView.dispatchKeyEvent(event!!) || super.dispatchKeyEvent(event)
}
AndroidTv.kt

Java

@Override
public boolean dispatchKeyEvent(KeyEvent event) {
  return playerView.dispatchKeyEvent(event) || super.dispatchKeyEvent(event);
}
AndroidTv.java

Solicitar el enfoque para el PlayerView es importante para navegar por los controles de reproducción y omitir anuncios. Considera solicitar el enfoque en onCreate de Activity:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  // ...
  playerView.requestFocus()
  // ...
}
AndroidTv.kt

Java

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  // ...
  playerView.requestFocus();
  // ...
}
AndroidTv.java

Si usas Compose en Android TV, debes hacer que AndroidView sea enfocable y delegar el evento pasando el parámetro del modificador a AndroidView según corresponda:

AndroidView(
  modifier = modifier.focusable().onKeyEvent { playerView.dispatchKeyEvent(it.nativeKeyEvent) },
  factory = { playerView },
)
AndroidTv.kt

Usa el elemento Player componible

Si usas el elemento Player componible de la biblioteca media3-ui-compose-material3, la navegación con pad direccional se admite de forma predeterminada. Los componentes Player y PlayerDefaults tienen una instancia FocusRequester automática que recorre los componentes con el pad direccional, por lo que no necesitas código adicional ni Modifier.focusRequester para controlar el enfoque y los eventos de teclas:

Los botones PlayerDefaults están dispuestos en ranuras superior, central e inferior para que la navegación con el pad direccional sea intuitiva. Para cualquier personalización y anulación de esos espacios, asegúrate de proporcionar un componente que se pueda navegar fácilmente. Ten en cuenta que la mayoría de los componentes de Compose, como Slider o Row que contienen botones, administran el enfoque de forma predeterminada.