Navegación con 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. Estas
se deben delegar a PlayerView:
Kotlin
override fun dispatchKeyEvent(event: KeyEvent?): Boolean { return playerView.dispatchKeyEvent(event!!) || super.dispatchKeyEvent(event) }
Java
@Override public boolean dispatchKeyEvent(KeyEvent event) { return playerView.dispatchKeyEvent(event) || super.dispatchKeyEvent(event); }
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() // ... }
Java
@Override public void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // ... playerView.requestFocus(); // ... }
Si usas Compose en Android TV, debes hacer que AndroidView sea enfocable y delegar el evento pasando el parámetro modificador a AndroidView según corresponda:
AndroidView( modifier = modifier.focusable().onKeyEvent { playerView.dispatchKeyEvent(it.nativeKeyEvent) }, factory = { playerView }, )
Usa el elemento componible Player
Si usas el elemento de componibilidad Player de la biblioteca de media3-ui-compose-material3, la navegación con pad direccional es compatible de forma predeterminada. Los componentes Player y PlayerDefaults tienen una instancia automática de FocusRequester que recorre los componentes con el pad direccional, por lo que no necesitas código adicional ni Modifier.focusRequester para controlar los eventos de enfoque y de teclas:
Los PlayerDefaults se organizan en ranuras superiores, centrales e inferiores 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 con facilidad. Ten en cuenta que la mayoría de los componentes de Compose, como Slider o Row que contienen botones, administran el enfoque de forma inmediata.