Gamecontroller-Bibliothek Teil des Android Game Development Kit
Mit der Game Controller-Bibliothek, auch bekannt als Paddleboat, können Sie eine stabile Unterstützung für Gamecontroller implementieren. Die Bibliothek bietet Folgendes:
- Callbacks zum Erkennen von Controller-Verbindungen und -Trennungen
- Informationen zu Controller-Geräten, einschließlich Schaltflächenstil und -layout
- Controller-Eingabedaten, standardisiert für moderne Dual-Stick-Controller-Designs
- Erweiterte Funktionen auf unterstützten Controllern, einschließlich Vibration, Beleuchtung, Daten zur Bewegungsachse und Akkustatus
- Kann Eingaben von virtuellen und physischen Mausgeräten lesen
- Möglichkeit, benutzerdefinierte Controller-Zuordnungsdaten für bestimmte Geräte anzugeben
Anforderungen an kompatible Geräte
Für die Gamecontroller-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
Die Game Controller-Bibliothek wird in zwei Formaten bereitgestellt: als Jetpack-Bibliothek für Spiele mit einem Gradle-basierten Build-System (einschließlich Android Studio) und als separate Dateien für Spiele mit benutzerdefinierten Build-Systemen.
Ein Beispiel, in das die Game Controller-Bibliothek integriert wird, findest du im games-sample-Repository.
Jetpack-Bibliothek
Auf der Seite Jetpack Android Games (Jetpack für Android-Spiele) finden Sie eine Integrationsanleitung, mit der Sie die Abhängigkeit der Gamecontroller-Bibliothek zur build.gradle
-Datei Ihres Spiels hinzufügen können.
Der Release der Jetpack-Bibliothek von Game Controller ist eine statische Bibliothek, die für die gemeinsam genutzte Bibliothek der C++-Laufzeit erstellt wurde.
Nachdem Sie die build.gradle
-Datei aktualisiert haben, müssen Sie die folgende Zeile in die CMakeLists.txt
-Hauptdatei Ihres Spiels einfügen:
find_package(games-controller REQUIRED CONFIG)
Außerdem müssen Sie der Liste der Bibliotheken im Befehl target_link_libraries
der gemeinsam genutzten Hauptbibliothek Ihres Spiels den folgenden Eintrag hinzufügen:
games-controller::paddleboat_static
Diskrete Dateien
Die Distribution .zip
des Android Game Development Kits enthält Header- und Bibliotheksdateien für die Game Controller-Bibliothek. Die folgenden Dateien müssen in deinem Projekt enthalten sein, um die Game Controller-Bibliothek verwenden zu können:
- Die Datei
classes.jar
, die die Dalvik-Bytecode-Teile der Game Controller-Bibliothek enthält. Die Datei befindet sich unterlibs/classes.jar
- Die Headerdatei der
paddleboat.h
-Schnittstelle. Die Datei befindet sich unterinclude/paddleboat/paddleboat.h
- Entweder die Datei der gemeinsam genutzten Bibliothek (
libpaddleboat.so
) oder die Datei der statischen Bibliothek (libpaddleboat-static.a
). Diese Dateien befinden sich in den Build-Konfigurationsunterverzeichnissen im Verzeichnislibs
.
Die Build-Konfigurationsunterverzeichnisse im Stammverzeichnis libs
sind nach folgenden Kategorien sortiert:
- ABI-Architektur
- Mindest-API-Level für Android
- Android-NDK-Version
- Version der C++-Laufzeitbibliothek
- Build-Konfiguration veröffentlichen oder debuggen
Das Unterverzeichnis arm64-v8a_API16_NDK21_cpp_shared_Release
enthält beispielsweise Bibliotheksdateien für:
- ARM 64-Bit-ABI
- Mindestens API-Level 16
- Erstellt für NDK Version 21
- Anhand der gemeinsam genutzten Bibliothek der C++-Laufzeitversion erstellt
- Release-Build-Konfiguration
Die Datei libpaddleboat_static.a
befindet sich direkt im Unterverzeichnis. Die Datei libpaddleboat.so
befindet sich im Unterverzeichnis unter lib/paddleboat/
.
Nächste Schritte
In den folgenden Leitfäden erfahren Sie, wie Sie die Game Controller-Mediathek weiter in Ihr Spiel integrieren:
- Game Controller-Bibliothek verwenden
- Mausunterstützung hinzufügen
- Benutzerdefinierte Controller-Gerätezuordnungen hinzufügen