Android TV

Android TV での D-pad ナビゲーション

Android TV のリモコンには D-pad コントロールがあり、Activity の dispatchKeyEvent(KeyEvent) にキーイベントとして届くコマンドを送信します。これらは PlayerView に委任する必要があります。

Kotlin

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

Java

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

PlayerView のフォーカスをリクエストすることは、再生コントロールの操作や広告のスキップに重要です。Activity の onCreate でフォーカスをリクエストすることを検討してください。

Kotlin

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

Java

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

Android TV で Compose を使用している場合は、AndroidView をフォーカス可能にし、修飾子パラメータを AndroidView に渡してイベントを委任する必要があります。

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

Player コンポーザブルを使用する

media3-ui-compose-material3 ライブラリの Player コンポーザブルを使用する場合、D-pad ナビゲーションはデフォルトでサポートされています。Player コンポーネントと PlayerDefaults コンポーネントには、D-pad でコンポーネントを走査する自動 FocusRequester インスタンスがあるため、フォーカス イベントとキーイベントを処理するための追加のコードや Modifier.focusRequester は必要ありません。

PlayerDefaults は上部、中央、下部のスロットに配置されているため、D-pad ナビゲーションは直感的に操作できます。これらのスロットをカスタマイズしたりオーバーライドしたりする場合は、ナビゲーションしやすいコンポーネントを提供してください。Slider やボタンを含む Row など、ほとんどの Compose コンポーネントは、すぐにフォーカスを管理できます。