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.1 (API-Level 16) oder höher
  • Android NDK Version 17 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 unter libs/classes.jar
  • Die Headerdatei der paddleboat.h-Schnittstelle. Die Datei befindet sich unter include/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 Verzeichnis libs.

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: