Android TV

Navegação com o D-pad no Android TV

O controle remoto do Android TV tem um controle D-pad que envia comandos que chegam como eventos de tecla em dispatchKeyEvent(KeyEvent) da sua Activity. Estes 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 a PlayerView é importante para navegar pelos controles de reprodução e pular anúncios. Considere solicitar o foco em onCreate da 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, será necessário tornar o AndroidView focalizável e delegar o evento transmitindo o parâmetro do modificador para o AndroidView de acordo:

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

Usar o elemento combinável Player

Se você usar o Player combinável da biblioteca media3-ui-compose-material3, a navegação com o D-pad 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 D-pad. Portanto, não é necessário usar código adicional ou Modifier.focusRequester para processar eventos de foco e tecla:

Os PlayerDefaults são organizados em slots superior, central e inferior para que a navegação com o D-pad seja intuitiva. Para personalizações e substituições desses slots, forneça um componente bem navegável. A maioria dos componentes do Compose, como Slider ou Row que contém botões, gerencia o foco de imediato.