Android TV

Navigazione con il D-pad su Android TV

Il telecomando di Android TV ha un D-pad che invia comandi che arrivano come eventi chiave a dispatchKeyEvent(KeyEvent) di Activity. Questi devono essere delegati a PlayerView:

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

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

Richiedere lo stato attivo per PlayerView è importante per navigare tra i controlli di riproduzione e saltare gli annunci. Valuta la possibilità di richiedere lo stato attivo in onCreate di Activity:

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

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

Se utilizzi Compose su Android TV, devi rendere attivabile AndroidView e delegare l'evento passando il parametro del modificatore a AndroidView di conseguenza:

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

Utilizza il composable Player

Se utilizzi l'elemento componibile Player della libreria media3-ui-compose-material3, la navigazione con il D-pad è supportata per impostazione predefinita. I componenti Player e PlayerDefaults hanno un'istanza FocusRequester automatica che attraversa i componenti con il D-pad, quindi non hai bisogno di codice aggiuntivo o di Modifier.focusRequester per gestire gli eventi di stato attivo e tasto:

Le PlayerDefaults sono disposte in slot in alto, al centro e in basso, in modo che la navigazione con il D-pad sia intuitiva. Per eventuali personalizzazioni e override di questi slot, assicurati di fornire un componente facilmente navigabile. Tieni presente che la maggior parte dei componenti di Compose, come Slider o Row contenenti pulsanti, gestisce lo stato attivo in modo predefinito.