Android TV

Android TV 上的方向键导航

Android TV 的遥控器具有方向键控件，该控件会发送命令，这些命令会作为按键事件到达 Activity 的 dispatchKeyEvent(KeyEvent)。这些需要委托给 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);
}

请求 PlayerView 的焦点对于浏览播放控件和跳过广告非常重要。考虑在 Activity 的 onCreate 中请求焦点：

Kotlin

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

Java

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

如果您在 Android TV 上使用 Compose，则需要使 AndroidView 可聚焦，并通过将修饰符参数相应地传入 AndroidView 来委托事件：

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

使用 Player 可组合项

如果您使用 media3-ui-compose-material3 库中的 Player 可组合项，系统会默认支持方向键导航。Player 和 PlayerDefaults 组件具有自动 FocusRequester 实例，该实例会使用方向键遍历组件，因此您无需额外的代码或 Modifier.focusRequester 即可处理焦点和按键事件：

PlayerDefaults 排列在顶部、中心和底部槽位中，因此方向键导航感觉很直观。对于这些槽位的任何自定义和替换，请确保提供易于导航的组件。请注意，大多数 Compose 组件（例如 Slider 或包含按钮的 Row）都支持开箱即用的焦点管理。