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) do seu Activity. Esses precisam ser delegados ao 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 o foco para o PlayerView é importante para navegar pelos controles de reprodução e pular anúncios. Considere solicitar o foco em onCreate do 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();
  // ...
}

Se você estiver usando o Compose no Android TV, precisará tornar o AndroidView focável e delegar o evento transmitindo o parâmetro de modificador para o AndroidView de acordo com o seguinte:

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

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á compatível por padrão. Os componentes Player e PlayerDefaults têm uma instância FocusRequester automática que percorre os componentes com o botão direcional. Assim, não é necessário código adicional nem Modifier.focusRequester para processar eventos de foco e tecla:

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