Game Controller Library   Teil des Android Game Development Kit.

Mit der Game Controller-Bibliothek, auch bekannt als Paddleboat, kannst du eine robuste Unterstützung für Gamecontroller 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 Controller-Verbindungen und -Verbindungstrennungen
  • Informationen zum Controller, einschließlich Tastenstil und -layout
  • Controller-Eingabedaten, standardisiert für moderne Dual-Stick-Controller-Designs
  • Erweiterte Funktionen auf unterstützten Controllern, einschließlich Vibration, Beleuchtung, Bewegungsachsendaten und Akkustand
  • Ermöglicht das Lesen von Eingaben von virtuellen und physischen Mäusen
  • Möglichkeit, benutzerdefinierte Controller-Zuordnungsdaten für bestimmte Geräte anzugeben

Anforderungen an kompatible Geräte

Für die Game Controller-Bibliothek gelten 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 zum Einbinden der Game Controller-Bibliothek in die Datei build.gradle Ihres Spiels.

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 der Hauptdatei CMakeLists.txt Ihres Spiels die folgende Zeile hinzufügen:

find_package(games-controller REQUIRED CONFIG)

Außerdem musst du der Liste der Bibliotheken im Befehl target_link_libraries der gemeinsam genutzten Hauptbibliothek deines Spiels den folgenden Eintrag hinzufügen:

games-controller::paddleboat_static

Ein Beispiel für die Einbindung der Game Controller-Bibliothek finden Sie im games-samples-Repository.

Nächste Schritte

In den folgenden Leitfäden finden Sie weitere Informationen zur Einbindung der Game Controller-Bibliothek in Ihr Spiel: