Android TV

Навигация с помощью D-pad на Android TV

Пульт дистанционного управления Android TV имеет D-pad, который отправляет команды, поступающие в виде событий нажатия клавиш, в dispatchKeyEvent(KeyEvent) вашей Activity . Эти команды необходимо делегировать PlayerView :

Котлин

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);
}

Запрос фокуса для PlayerView важен для навигации по элементам управления воспроизведением и пропуска рекламы. Рекомендуется запрашивать фокус в методе onCreate Activity :

Котлин

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

Java

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

Если вы используете Compose на Android TV, вам необходимо сделать AndroidView фокусируемым и делегировать событие, передав соответствующий параметр-модификатор в AndroidView :

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

Используйте составной Player

Если вы используете компонент Player из библиотеки media3-ui-compose-material3 , навигация с помощью D-pad поддерживается по умолчанию. Компоненты Player и PlayerDefaults имеют автоматический экземпляр FocusRequester , который обходит компоненты с помощью D-pad, поэтому вам не потребуется дополнительный код или Modifier.focusRequester для обработки событий фокусировки и нажатия клавиш:

Параметры PlayerDefaults расположены в верхнем, центральном и нижнем слотах, чтобы навигация с помощью D-pad была интуитивно понятной. Для любых настроек и переопределений этих слотов убедитесь, что вы предоставляете компонент с удобной навигацией. Обратите внимание, что большинство компонентов Compose, таких как Slider или Row , содержащие кнопки, управляют фокусом по умолчанию.