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:
- Game Controller-Bibliothek verwenden
- Mausunterstützung hinzufügen
- Benutzerdefinierte Controller-Gerätezuordnungen hinzufügen