Game Controller Library   Teil des Android Game Development Kit.

Die Game Controller-Bibliothek, auch bekannt als Paddleboat, hilft Ihnen dabei, eine robuste Unterstützung für Gamecontroller zu implementieren. Die Game Controller-Bibliothek wird als Jetpack-Bibliothek für Spiele mit einem Gradle-basierten Build-System (einschließlich Android Studio) bereitgestellt. Die Bibliothek bietet Folgendes:

  • Callbacks zum Erkennen von Controllerverbindungen und ‑trennungen
  • Informationen zum Controllergerät, einschließlich Schaltflächenstil und ‑layout
  • Controller-Eingabedaten, standardisiert für moderne Dual-Stick-Controller
  • Erweiterte Funktionen auf unterstützten Controllern, einschließlich Vibration, Beleuchtung, Daten zur Bewegungsachse und Akkustand
  • Eingaben von virtuellen und physischen Mäusen lesen
  • Möglichkeit, benutzerdefinierte Controller-Zuordnungsdaten für bestimmte Geräte anzugeben

Anforderungen an kompatible Geräte

Die Game Controller-Bibliothek hat die folgenden Mindestanforderungen an die Kompatibilität:

  • Android 4.4 (API‑Level 19) oder höher
  • Android NDK-Version 21 oder höher

Einbinden

Auf der Seite Jetpack Android Games finden Sie eine Anleitung zur Integration, mit der Sie die Abhängigkeit der Game Controller-Bibliothek in die build.gradle-Datei Ihres Spiels einfügen können.

Die Jetpack-Bibliotheksversion von Game Controller ist eine statische Bibliothek, die für die gemeinsam genutzte C++-Laufzeitbibliothek erstellt wurde.

Nachdem Sie die Datei build.gradle aktualisiert haben, müssen Sie die folgende Zeile in die Hauptdatei CMakeLists.txt Ihres Spiels einfügen:

find_package(games-controller REQUIRED CONFIG)

Außerdem müssen Sie der Liste der Bibliotheken im target_link_libraries-Befehl der gemeinsam genutzten Hauptbibliothek Ihres Spiels den folgenden Eintrag hinzufügen:

games-controller::paddleboat_static

Ein Beispiel, in dem die Game Controller-Bibliothek eingebunden ist, finden Sie im games-samples-Repository.

Nächste Schritte

In den folgenden Anleitungen erfahren Sie, wie Sie die Game Controller-Bibliothek in Ihr Spiel einbinden: