Android TV

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

Android TV のリモコンには、Activity の dispatchKeyEvent(KeyEvent) にキーイベントとして届くコマンドを送信する十字キー操作があります。これらは 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 のフォーカスをリクエストすることは、再生コントロールの操作や広告のスキップに重要です。Activity の onCreate でフォーカスをリクエストすることを検討してください。

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

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 コンポーネントは、すぐに使えるフォーカスを管理します。