Android TV

Навигация с помощью крестовины на Android TV

Пульт ДУ Android TV оснащен D-pad, который отправляет команды в виде ключевых событий в dispatchKeyEvent(KeyEvent) вашего Activity. Эти разрешения необходимо делегировать 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

Запрос фокуса для PlayerView важен для навигации по элементам управления воспроизведением и пропуска рекламы. Попробуйте запросить фокус в onCreate из 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

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

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

Как использовать функцию Player

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

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