ゲーム コントローラ ライブラリ   Android Game Development Kit の一部。

Paddleboat とも呼ばれるゲーム コントローラ ライブラリは、ゲーム コントローラの安定したサポートを実装するのに役立ちます。ゲーム コントローラ ライブラリは、Gradle ベースのビルドシステム(Android Studio を含む)を使用するゲーム用の Jetpack ライブラリとして配布されます。このライブラリは、以下のものを提供します。

  • コントローラの接続と接続解除を検出するコールバック
  • コントローラ デバイスの情報(ボタンのスタイルやレイアウトなど)
  • 最新のデュアルスティック コントローラ設計で標準化されたコントローラ入力データ
  • サポートされているコントローラ拡張機能(バイブレーション、ライト、モーション軸のデータ、バッテリーの状態など)
  • 仮想および物理のマウスデバイスから入力を読み取る機能
  • 特定のデバイス用のカスタムのコントローラ マッピング データを指定する機能

互換性要件

ゲーム コントローラ ライブラリには、以下の最小互換性要件があります。

  • Android 4.4(API レベル 19)以降
  • Android NDK バージョン 21 以降

統合

Jetpack Android Games のページでは、ゲームの build.gradle ファイルにゲーム コントローラ ライブラリの依存関係を追加するための統合手順を説明しています。

ゲーム コントローラの Jetpack ライブラリ リリースは、C++ のランタイム共有ライブラリに対してビルドされた静的ライブラリです。

build.gradle ファイルを更新したら、ゲームのメインの CMakeLists.txt ファイルに次の行を追加する必要があります。

find_package(games-controller REQUIRED CONFIG)

また、ゲームのメイン共有ライブラリの target_link_libraries コマンドで、ライブラリ リストに次のエントリを追加する必要があります。

games-controller::paddleboat_static

ゲーム コントローラ ライブラリを統合するサンプルについては、games-samples リポジトリをご覧ください。

次のステップ

ゲーム コントローラ ライブラリを引き続きゲームに統合するには、次のガイドをご覧ください。