Gamecontroller-Mediathek Teil des Android Game Development Kit.

Mit der Game Controller-Bibliothek, auch als Paddleboat genannt, kannst du für Controller. Die Bibliothek bietet Folgendes:

  • Callbacks zum Erkennen von Controllerverbindungen und Verbindungsabbrüchen
  • Informationen zum Controllergerät, einschließlich Schaltflächenstil und -layout
  • Controller-Eingabedaten, standardisiert auf einen modernen Dual-Stick-Controller Designs
  • Erweiterte Funktionen auf unterstützten Controllern, einschließlich Vibration, Lichter, Bewegungsachsen-Daten und Akkustatus
  • Eingabe von virtuellen und physischen Mausgeräten kann gelesen werden
  • 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

Integrieren

Die Game Controller-Bibliothek wird in zwei Formaten vertrieben: als Jetpack Bibliothek für Spiele mit einem Gradle-basierten Build-System (einschließlich Android Studio) und als eigenständige Dateien für Spiele mit benutzerdefinierten Build-Systemen.

Ein Beispiel mit der Game Controller-Bibliothek finden Sie in der Repository für Spielebeispiele.

Jetpack-Bibliothek

Die Seite Jetpack Android Games Integrationsanleitung zum Hinzufügen der Abhängigkeit der Game Controller-Bibliothek zu Ihrem Datei build.gradle des Spiels.

Das Jetpack-Bibliotheksrelease des Game Controllers ist ein statisches die auf der gemeinsam genutzten C++-Laufzeitbibliothek basiert.

Nachdem Sie Ihre build.gradle-Datei aktualisiert haben, müssen Sie Folgendes hinzufügen: in die CMakeLists.txt-Hauptdatei Ihres Spiels einfügen:

find_package(games-controller REQUIRED CONFIG)

Sie müssen der Liste der Bibliotheken außerdem den folgenden Eintrag hinzufügen im Befehl target_link_libraries des freigegebenen Hauptteils deines Spiels Bibliothek:

games-controller::paddleboat_static

Diskrete Dateien

Die .zip-Archivveröffentlichung des Android Game Development Kit enthält für die Game Controller-Bibliothek. Die folgenden Dateien muss in Ihrem Projekt enthalten sein, damit Sie die Game Controller-Bibliothek verwenden können:

  • Die Datei classes.jar mit den Dalvik-Bytecode-Teilen des Game Controller-Bibliothek. Diese Datei befindet sich unter libs/classes.jar.
  • Die paddleboat.h-Schnittstellenheaderdatei. Diese Datei befindet sich unter include/paddleboat/paddleboat.h
  • Entweder die Datei mit der gemeinsam genutzten Bibliothek libpaddleboat.so oder der libpaddleboat-static.a statische Bibliotheksdatei. Diese Dateien wurden gefunden in den Unterverzeichnissen der Build-Konfiguration im Verzeichnis libs.

Die Unterverzeichnisse der Build-Konfiguration im Stammverzeichnis libs sind kategorisiert nach:

  • ABI-Architektur
  • Mindestvoraussetzung für Android API-Level
  • Android-NDK-Version
  • Version der C++-Laufzeitbibliothek
  • Build-Konfiguration veröffentlichen oder debuggen

Beispiel: Das Unterverzeichnis arm64-v8a_API16_NDK21_cpp_shared_Release enthält Bibliotheksdateien für:

  • ARM 64-Bit-ABI
  • Mindest-API-Level 16
  • Erstellt für NDK Version 21
  • Erstellt für die Version der gemeinsam genutzten Bibliothek der C++-Laufzeit
  • Build-Konfiguration des Release

Die Datei libpaddleboat_static.a befindet sich direkt im Unterverzeichnis. Die Die Datei libpaddleboat.so befindet sich im Unterverzeichnis unter lib/paddleboat/.

Nächste Schritte

In den folgenden Leitfäden erfahren Sie, wie Sie die Gamecontroller-Bibliothek weiter in Ihr Spiel integrieren: