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 可组合项，则默认情况下支持 D-pad 导航。Player 和 PlayerDefaults 组件具有一个自动 FocusRequester 实例，该实例可使用 D-pad 遍历组件，因此您无需使用额外的代码或 Modifier.focusRequester 来处理焦点和按键事件：

PlayerDefaults 分别位于顶部、中间和底部插槽中，因此 D-pad 导航操作起来非常直观。对于这些插槽的任何自定义设置和替换，请确保您提供易于浏览的组件。请注意，大多数 Compose 组件（例如包含按钮的 Slider 或 Row）都可以开箱即用地管理焦点。