Android TV

Navegação com botão direcional no Android TV

O controle remoto do Android TV tem um botão direcional que envia comandos que chegam como eventos de tecla em dispatchKeyEvent(KeyEvent) da sua Activity. Eles precisam ser delegados ao 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 o foco para o PlayerView é importante para navegar pelos controles de mídia e pular anúncios. Considere solicitar o foco em onCreate do 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

Se você estiver usando o Compose no Android TV, torne o AndroidView focalizável e delegue o evento transmitindo o parâmetro modificador para o AndroidView:

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

Usar o elemento combinável Player

Se você usar o elemento combinável Player da biblioteca media3-ui-compose-material3, a navegação pelo botão direcional será aceita por padrão. Os componentes Player e PlayerDefaults têm uma instância automática de FocusRequester que percorre os componentes com o botão direcional. Assim, você não precisa de código extra ou Modifier.focusRequester para processar eventos de foco e de tecla:

Os PlayerDefaults são organizados em slots na parte de cima, no centro e na parte de baixo para que a navegação do botão direcional seja intuitiva. Para personalizações e substituições desses slots, forneça um componente de fácil navegação. A maioria dos componentes do Compose, como Slider ou Row que contêm botões, gerencia o foco automaticamente.